كيفية استقبال الرسائل القصيرة من PHP

أبسط طريقة لإرسال الرسائل القصيرة من PHP هي استخدام واجهة برمجة تطبيقات HTTP/Rest المدمجة في بوابة Ozeki SMS. عند استخدام هذه الواجهة، ستستقبل رسائل SMS عن طريق إرسال طلب HTTP Get إلى بوابة الرسائل القصيرة. سترد البوابة برد HTTP 200 OK على طلبك.

كيفية استقبال الرسائل القصيرة من PHP
الشكل 1 - كيفية استقبال الرسائل القصيرة من PHP

كود PHP لاستقبال الرسائل القصيرة من الهاتف المحمول

يوضح مثال كود PHP للرسائل القصيرة أدناه كيفية إرسال الرسائل القصيرة باستخدام واجهة برمجة تطبيقات HTTP Rest الخاصة ببوابة Ozeki SMS باستخدام مكتبة PHP Ozeki.Libs.Rest. هذه المكتبة مقدمة لك مجانًا، ويمكنك استخدامها وتعديلها في أي من مشاريعك.

SendSMS.cs

namespace Ozeki_PHP_Rest
{
require 'MessageApi/MessageApi.php';

		$configuration = new Configuration();
		
		$configuration -> Username = "http_user";
		$configuration -> Password = "qwe123";
		$configuration -> ApiUrl = "http://127.0.0.1:9509/api";
					
		$api = new MessageApi($configuration);
		
		$result = $api -> DownloadIncoming();	
			
		echo "المجلد: " . $result -> Folder;
		echo "
"; echo "الحد: " . $result -> Limit; echo "
"; echo strval($result); echo "
"; echo "الرسائل:"; echo "
"; foreach($result->Messages as $msg) { echo "من: ". $msg->FromAddress . " النص: " . $msg->Text; echo "
"; } }

كيفية استخدام مثال PHP للرسائل القصيرة:

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

تحميل ReceiveSMS.php

يمكن تنزيل كود المصدر الموضح في هذه المقالة واستخدامه وتعديله مجانًا.
تحميل: ReceiveSMS.zip (5.9 كيلوبايت)

ما الموجود في ملف ReceiveSMS.zip؟

يحتوي ملف SendSMS.zip على مكتبة Ozeki.Libs.Rest.Php، والتي تمنحك جميع الأدوات اللازمة لإرسال واستقبال الرسائل القصيرة. ستجد أيضًا مشروع ReceiveSms في الملف المضغوط، والذي يحتوي على كود المثال ليوضح لك كيفية إرسال رسالة SMS. كود المثال هذا مدرج أدناه.

الشكل 2 - ما الموجود داخل ReceiveSMS.zip

كيفية استقبال الرسائل القصيرة من PHP (خطوات سريعة)

لإرسال الرسائل القصيرة من PHP:

  1. قم بتثبيت بوابة Ozeki SMS
  2. قم بتوصيل بوابة Ozeki SMS بالشبكة الخلوية
  3. استقبل رسالة اختبارية من واجهة Ozeki
  4. قم بإنشاء مستخدم لواجهة برمجة تطبيقات HTTP للرسائل القصيرة
  5. ابدأ تشغيل خادم Wamp
  6. قم بتنزيل المثال أعلاه
  7. قم بإنشاء طلب استقبال الرسائل القصيرة
  8. استخدم طريقة الاستقبال لاستلام رسالتك
  9. اقرأ رد HTTP
  10. تحقق من السجلات في بوابة الرسائل القصيرة

قم بتثبيت بوابة Ozeki SMS وأنشئ مستخدمًا لواجهة برمجة تطبيقات HTTP

لتتمكن من استقبال الرسائل القصيرة من PHP، تحتاج أولاً إلى إنشاء مستخدم لواجهة برمجة تطبيقات HTTP للرسائل القصيرة. قم بإنشاء مستخدم باسم مستخدم "http_user"، وكلمة مرور "qwe123" لجعل المثال يعمل دون تعديل.

بعد إعداد البيئة، يمكنك تشغيل كود PHP الخاص بك.

رابط واجهة برمجة تطبيقات HTTP لاستقبال الرسائل القصيرة من PHP

لإرسال الرسائل القصيرة من PHP، سيتعين على PHP الخاص بك إرسال طلب HTTP إلى بوابة الرسائل القصيرة. يظهر رابط واجهة برمجة التطبيقات أدناه. لاحظ أنه يجب استبدال عنوان IP (127.0.0.1) بعنوان IP الخاص ببوابة الرسائل القصيرة الخاصة بك. إذا تم تثبيت بوابة Ozeki SMS على نفس الكمبيوتر الذي يعمل عليه تطبيق الرسائل القصيرة بلغة C#، فيمكن أن يكون هذا 127.0.0.1. إذا تم تثبيته على كمبيوتر مختلف، فيجب أن يكون عنوان IP الخاص بهذا الكمبيوتر.

http://127.0.0.1:9509/api?action=rest

رأس طلب HTTP لاستقبال الرسائل القصيرة من PHP

لإرسال الرسائل القصيرة، تحتاج إلى تضمين الأسطر التالية كرؤوس في طلب HTTP. لاحظ أننا ندرج نوع المحتوى ورأس التفويض.

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

طلب HTTP لاستقبال الرسائل القصيرة من PHP

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

GET /api?action=receivemsg&folder=inbox HTTP/1.1
Content-Type: application/json
Accept: */*
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509

استجابة HTTP المستلمة بواسطة مثال PHP للرسائل القصيرة

بمجرد أن يستقبل بوابة الرسائل القصيرة هذا الطلب، سوف يقوم بإنشاء استجابة HTTP. ستحتوي استجابة HTTP على رمز حالة، للإشارة إلى ما إذا كان طلب إرسال الرسالة القصيرة ناجحًا أم لا. كما ستعود أيضًا ببنية مشفرة بتنسيق JSON لتزويدك بتفاصيل مفيدة حول إرسال الرسالة.

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.120 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Thu, 17 Jun 2021 09:18:12 GMT
Server: 10/10.3.120
Transfer-Encoding: chunked

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "",
  "data": {
    "folder": "inbox",
    "limit": "1000",
    "data": [
      {
        "message_id": "16673c81-0568-49af-a0fa-1e4b3d6bb500",
        "from_connection": "SMPP_client_1@localhost",
        "from_address": "+36301111111",
        "from_station": "%",
        "to_connection": "http_user@localhost",
        "to_address": "+36308888888",
        "to_station": "%",
        "text": "Hello World  1!",
        "create_date": "2021-06-17 10:01:55",
        "valid_until": "2021-06-24 10:01:55",
        "time_to_send": "2021-06-17 10:01:55",
        "submit_report_requested": true,
        "delivery_report_requested": false,
        "view_report_requested": false,
        "tags": [
          {
            "name": "PduCount",
            "value": "1"
          }
        ]
      },
      {
        "message_id": "8ed7f65b-d3b5-4b68-8b4d-25b63dad0cc8",
        "from_connection": "SMPP_client_1@localhost",
        "from_address": "+36302222222",
        "from_station": "%",
        "to_connection": "http_user@localhost",
        "to_address": "+36308888888",
        "to_station": "%",
        "text": "Hello World  2!",
        "create_date": "2021-06-17 10:02:03",
        "valid_until": "2021-06-24 10:02:03",
        "time_to_send": "2021-06-17 10:02:03",
        "submit_report_requested": true,
        "delivery_report_requested": false,
        "view_report_requested": false,
        "tags": [
          {
            "name": "PduCount",
            "value": "1"
          }
        ]
      },
      {
        "message_id": "56ad323c-b19b-4406-af2d-cf2eb365e725",
        "from_connection": "SMPP_client_1@localhost",
        "from_address": "+36303333333",
        "from_station": "%",
        "to_connection": "http_user@localhost",
        "to_address": "+36308888888",
        "to_station": "%",
        "text": "Hello World  3!",
        "create_date": "2021-06-17 10:02:27",
        "valid_until": "2021-06-24 10:02:27",
        "time_to_send": "2021-06-17 10:02:27",
        "submit_report_requested": true,
        "delivery_report_requested": false,
        "view_report_requested": false,
        "tags": [
          {
            "name": "PduCount",
            "value": "1"
          }
        ]
      }
    ]
  }
}

كيفية استقبال الرسائل القصيرة من PHP باستخدام واجهة برمجة تطبيقات الرسائل القصيرة في PHP (فيديو تعليمي)

يُظهر لك هذا الفيديو كيفية تنزيل واستخدام مشروع ReceiveSMS php. بمجرد إضافة الملفات المطلوبة إلى مشروعك، قد تلاحظ وجود ملف يسمى MessageApi.php. هذا هو الملف الذي يحتوي على MessageApi وكل الأشياء التي تحتاجها لإرسال رسالة قصيرة باستخدام PHP.

الفيديو 1 - كيفية تنزيل وتشغيل مشروع المثال (فيديو تعليمي)

مثال PHP للرسائل القصيرة: Receive_Message.php

الشكل 3 - Receive_Message.php

كيفية التحقق من قبول الرسالة القصيرة من قبل مستخدم HTTP

بعد إرسال الرسالة القصيرة، من الجيد التحقق من بوابة الرسائل القصيرة الخاصة بك، لمعرفة ما تم استلامه. يمكنك التحقق من السجل عن طريق فتح تفاصيل مستخدم HTTP من وحدة تحكم إدارة بوابة Ozeki للرسائل القصيرة. يُظهر لك الفيديو التالي ما يجب البحث عنه.

الفيديو 2 - استقبال الرسائل القصيرة باستخدام كود PHP أعلاه (فيديو تعليمي)

للتلخيص

شرح هذا المقال كيفية استقبال الرسائل القصيرة باستخدام واجهة برمجة تطبيقات REST HTTP لبوابة Ozeki للرسائل القصيرة في PHP. إذا كنت قد اتبعت الخطوات أعلاه، فأنت الآن قادر على إنشاء مستخدم HTTP لواجهة برمجة تطبيقات الرسائل القصيرة في بوابة Ozeki للرسائل القصيرة لاستقبال الرسائل القصيرة باستخدام PHP. يمكن استخدام هذه الخدمة في أي وقت، بحيث يمكن توسيع نظام PHP الحالي الخاص بك بإمكانيات الرسائل القصيرة.

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

الشيء التالي الذي عليك القيام به هو تنزيل بوابة Ozeki للرسائل القصيرة والاستمتاع بالمزايا.

More information