إرسال SMS باستخدام PHP: مكتبات API للتكامل

إرسال SMS باستخدام PHP: مكتبات API للتكامل السريع

لا يزال إرسال رسائل SMS من أكثر الطرق الموثوقة لإخطار المستخدمين: تأكيد الطلب، المصادقة الثنائية، تذكير بالأحداث. بالنسبة لـ PHP، توجد العديد من المكتبات الجاهزة التي تسهل العمل مع مزودي خدمة SMS عبر API الخاص بهم. في هذه المقالة، سنستعرض الحلول الشائعة، وطرق تثبيتها، وأمثلة كود لإرسال الرسائل.

لماذا استخدام مكتبة لإرسال SMS؟

يتطلب العمل اليدوي مع طلبات HTTP إلى API بوابة SMS كتابة كمية كبيرة من الكود النمطي: تشكيل الرؤوس، معالجة الأخطاء، العمل مع JSON/XML، التحقق من الحالات. المكتبة الجاهزة تتولى هذه المهام، وتوفر واجهة كائنية نقية. هذا يسرع التطوير ويقلل من احتمالية الأخطاء.

المكتبات الشائعة لإرسال SMS باستخدام PHP

يعتمد اختيار المكتبة على مزود خدمة SMS المستخدم. سنستعرض خيارين شائعين:

• Twilio PHP SDK – المكتبة الرسمية للعمل مع Twilio. تدعم إرسال SMS، المكالمات الصوتية، التحقق من الرقم.
• SMS Aero PHP SDK – مكتبة للخدمة الروسية SMS Aero. تتيح إرسال الرسائل، التحقق من الرصيد، الحصول على الإحصائيات.

التثبيت عبر Composer

معظم مكتبات PHP الحديثة يتم تثبيتها عبر Composer. قم بتنفيذ الأمر في الطرفية:

composer require twilio/sdk

لـ SMS Aero:

composer require sms-aero/sms-aero-php

بعد التثبيت، قم بتضمين أداة التحميل التلقائي في السكريبت الخاص بك:

require_once 'vendor/autoload.php';

مثال إرسال SMS عبر Twilio

للعمل مع Twilio، ستحتاج إلى Account SID و Auth Token (موجودان في لوحة تحكم Twilio). مثال كود:

<?phprequire_once 'vendor/autoload.php';

use Twilio\\Rest\\Client;

$sid    = "your_account_sid";$token  = "your_auth_token";$twilio = new Client($sid, $token);

$message = $twilio->messages    ->create(        "+71234567890", // رقم المستلم        [            "from" => "+12345678901", // رقم المرسل (مشترى من Twilio)            "body" => "مرحباً! هذه رسالة SMS تجريبية من PHP."        ]    );

echo "تم إرسال الرسالة. المعرف: " . $message->sid;?>

في حالة النجاح، يقوم الأسلوب create() بإرجاع كائن يحتوي على معلومات الرسالة. في حالة الخطأ، يتم إلقاء استثناء TwilioException.

مثال إرسال SMS عبر SMS Aero

للخدمة الروسية SMS Aero، ستحتاج إلى البريد الإلكتروني و مفتاح API. مثال:

<?phprequire_once 'vendor/autoload.php';

use SmsAero\\SmsAeroClient;

$client = new SmsAeroClient('your_email@example.com', 'your_api_key');

try {    $response = $client->sendSms(        '71234567890',        'نص الرسالة',        'SENDER_NAME' // اسم المرسل المسجل في الخدمة    );    echo "تم إرسال SMS. المعرف: " . $response->id;} catch (Exception $e) {    echo "خطأ: " . $e->getMessage();}?>

يقوم الأسلوب sendSms() بإرجاع كائن استجابة يحتوي على حالة التسليم، معرف الرسالة، والرصيد.

الإمكانيات الرئيسية للمكتبات

• إرسال رسائل فردية وجماعية – يمكن إرسال رسالة واحدة أو قائمة أرقام.
• التحقق من حالة التسليم – طلب الحالة حسب معرف الرسالة.
• إدارة المرسلين – تسجيل واختيار اسم المرسل.
• العمل مع القوالب – لبعض مزودي الخدمة، يمكن استخدام قوالب رسائل محددة مسبقاً.
• الرصيد والإحصائيات – الحصول على الرصيد الحالي والتقارير.