استقبال الرسائل القصيرة (SMS) باستخدام PHP

سيوضح هذا المستند كيفية استقبال رسائل SMS باستخدام تطبيق ويب أو موقع إلكتروني يستخدم كود PHP. يقوم كود PHP ببدء طلبات HTTP إلى بوابة الرسائل القصيرة (SMS Gateway) للحصول على الرسائل الواردة. يستقبل الكود هذه الرسائل كرد من بوابة الرسائل القصيرة، ومن ثم يمكنك استخدام هذه الرسائل في تطبيق الويب الخاص بك.

ما هي واجهة برمجة تطبيقات الرسائل القصيرة (SMS API) في PHP؟

تتيح لك واجهة برمجة تطبيقات الرسائل القصيرة (SMS API) في PHP إرسال رسائل SMS من تطبيق ويب أو موقع إلكتروني. تستخدم الواجهة طلبات HTTP للتواصل مع بوابة الرسائل القصيرة التي تقوم بتسليم الرسالة وإرسال رد.

المتطلبات الأساسية

استقبال الرسائل القصيرة (SMS) باستخدام PHP

  • افتح لوحة تحكم XAMPP
  • ابدأ خدمة Apache
  • افتح المفكرة (Notepad)
  • انسخ والصق كود PHP الموجود أدناه
  • احفظ الملف في مجلد xampp/htmldocs باسم index.php
  • افتح بوابة الرسائل القصيرة (SMS Gateway) واختر اتصال خادم HTTP
  • أرسل بعض الرسائل الاختبارية
  • اكتب 'localhost' في متصفحك لتشغيل كود PHP

الفيديو 1 - كيفية استقبال الرسائل القصيرة باستخدام PHP (شرح بالفيديو)

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

<!DOCTYPE html>
<html>
<head>
    <title>إرسال طلب HTTP</title>
</head>
<body>
    <?php    
        $username = "john";
        $password = "Xc3ffs";
        $httpUrl = "https://127.0.0.1:9508/";
        $folder = "inbox";
        $limit = "3";
 
        $sendString = $httpUrl."api?action=receivemessage&username="
                     .$username."&password=".$password."&folder="
                     .$folder."&limit=".$limit
                     ."&messagedata=&afterdownload=delete";
 
        echo '<p><b> إرسال طلب HTML:</b> '.$sendString.'</p>';
        $aContext = array(
            'http' => array(
                'method'  => 'GET',
            ),
            'ssl' => array(
                'verify_peer' => false,
                'verify_peer_name' => false,
            )
        );
        $cxContext = stream_context_create($aContext);
        $response = file_get_contents($sendString, true, $cxContext);
 
        echo '<p><b> تم استقبال رد HTTP:</b> </p>';
        DisplayMessages($response);
        

        function DisplayMessages($response){
            $xml = simplexml_load_string($response);
            if($xml -> data -> message == "No more messages."){
                echo '<p><b>صندوق الوارد فارغ</b></p>';
                return;
            }

            foreach ($xml -> data -> message as $value) {
                $sender  = $value -> originator;
                $text = $value -> messagedata;
                DisplayMessage($sender, $text);
            }
        }

        function DisplayMessage($sender, $text){
            echo '<p><b>'.$sender.': '.$text.'</b></p>';
        }
    ?>
</body>
</html>

الخطوة 1 - افتح لوحة تحكم XAMPP

الخطوة الأولى من الدليل هي إعداد خادم Apache على جهازك القادر على تنفيذ أكواد PHP. يمكن إعداد هذه الخوادم المحلية بسهولة باستخدام XAMPP. إذا لم يكن لديك هذا التطبيق بعد، تحقق من قسم المتطلبات الأساسية في هذه الصفحة لتنزيله. إذا كنت قد قمت بتثبيته بالفعل على جهازك، فما عليك سوى فتح لوحة تحكم XAMPP كما تراه في الشكل 1. هنا، تحتاج إلى بدء خدمة Apache.

بدء خادم Apache
الشكل 1 - افتح لوحة تحكم XAMPP، ثم ابدأ خادم Apache

الخطوة 2 - انسخ كود PHP من هذه الصفحة

الخطوة التالية من هذا الدليل هي الحصول على الكود من هذه الصفحة لاستخدامه في حلك. لهذا، انتقل إلى كود المثال في هذه الصفحة، وقم بتحديد الكود بأكمله. ثم اضغط على Ctrl+C في لوحة المفاتيح كما تراه في الشكل 2 لنسخ الكود إلى الحافظة الخاصة بك.

نسخ كود PHP المصدر
الشكل 2 - نسخ كود PHP المصدر من الموقع

الخطوة 3 - لصق الكود في مستند نصي

لتشغيل الكود على خادمك المحلي، تحتاج إلى ملف يحتوي على كود PHP. لذلك، افتح تطبيق المفكرة وأنشئ ملف نصي جديدًا. هنا، ما عليك سوى الضغط على Ctrl+V على لوحة المفاتيح للصق الكود المصدري في ذلك المستند النصي كما يوضح الشكل 3. أخيرًا، تحتاج إلى حفظ الملف في مجلد xampp/htdocs وتسمية الملف باسم 'index.php' لتتمكن من تشغيله من خادمك المحلي.

لصق الكود في المفكرة
الشكل 3 - افتح المفكرة والصق كود PHP من الموقع

الخطوة 4 - إرسال بعض الرسائل الاختبارية

الآن، كود المثال جاهز للتشغيل، ولكن أولاً، تحتاج إلى وجود بعض الرسائل في مجلد الوارد الخاص بك. لأغراض الاختبار، يمكنك استخدام اتصال خادم HTTP لإرسال بعض الرسائل الاختبارية إلى نفسك واختبار كود PHP المثال. لذا، افتح بوابة الرسائل القصيرة وحدد اتصال خادم HTTP. هنا، افتح النموذج HTML للاتصال، وكما في الشكل 4، أرسل بعض الرسائل إلى المستلم 'Ozeki'.

محاكاة رسائل واردة
الشكل 4 - محاكاة بعض الرسائل الواردة

الخطوة 5 - تشغيل كود PHP

الخطوة الأخيرة هي اختبار الحل الخاص بك وكود PHP. للقيام بذلك، افتح متصفح الويب الخاص بك، واكتب 'localhost' كعنوان كما تراه في الشكل 5. إذا ضغطت على Enter، سيتم تنفيذ كود PHP المثال، وسوف تتمكن من رؤية النتيجة في المتصفح. هذا يظهر طلب HTTP الذي تم إرساله إلى بوابة الرسائل القصيرة ورسالة الرد التي تسرد جميع الرسائل القصيرة التي استقبلتها بوابة الرسائل القصيرة مع رقم هاتف المرسل ونص الرسالة أيضًا.

تشغيل كود PHP
الشكل 5 - تشغيل كود PHP في المتصفح

ملخص

في هذه المقالة، ستتعلم كيفية استقبال رسائل SMS باستخدام واجهة برمجة تطبيقات الرسائل القصيرة PHP. باستخدام بوابة Ozeki للرسائل القصيرة بمساعدة واجهة برمجة التطبيقات،这意味着 يمكنك إدارتها باستخدام طلبات PHP.

من الجيد الاطلاع على مقالات Ozeki، حتى تتمكن من معرفة المزيد عن نظام الاتصال الذي تقدمه Ozeki. لمعرفة المزيد حول كيفية استخدام بوابة Ozeki للرسائل القصيرة، لا تتردد في استكشاف المقالات على الموقع مثل: "كيفية إرسال رسائل SMS باستخدام C#".

لإنشاء أول نظام عالي الأداء للبوابة الرسائل القصيرة الخاص بك، الآن هو أفضل وقت لتحميل بوابة Ozeki للرسائل القصيرة!

More information