Hogyan küldjünk több SMS-t PHP-ból

A legegyszerűbb módja az SMS küldésének PHP-ból az Ozeki SMS Gateway beépített HTTP/Rest SMS API-jának használata. Amikor ezt az API-t használod, SMS üzeneteket küldhetsz HTTP POST kérések kiadásával az SMS gateway felé. A HTTP POST kérés egy JSON formátumban formázott üzenetet fog tartalmazni. Az SMS gateway továbbítja ezt az SMS-t a címzett telefonszámára, és egy HTTP 200 OK választ küld vissza a kérésedre.

hogyan küldjünk több SMS-t PHP-ból
1. ábra - Hogyan küldjünk több SMS-t PHP-ból

PHP kód SMS küldésére mobilra

Az alábbi PHP SMS kódminta bemutatja, hogyan küldhetsz SMS-t az Ozeki SMS Gateway HTTP REST SMS API-jával a PHP Ozeki.Libs.Rest könyvtár segítségével. Ez a könyvtár ingyenesen elérhető, és bármilyen projektben felhasználhatod és módosíthatod.

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"; 	
		$msg1 = new Message();
		$msg2 = new Message();
		
		$msg1 -> ToAddress = "+36201111111";
		$msg1 -> Text = "Hello, World 1!";
		$msg2 -> ToAddress = "+36202222222";
		$msg2 -> Text = "Hello, World 2!";
			
		$api = new MessageApi($configuration);
		
		$result = $api -> SendMultiple([$msg1,$msg2]);	
		
		echo strval($result);
}

Hogyan használd a PHP SMS példát:

Ez a PHP SMS példa bármilyen PHP alkalmazásban használható. A használatához hozzá kell adnod a MessageApi mappát a projektedhez. A Message osztály segítségével létrehozhatod az SMS-t, és a MessageApi osztály segítségével elküldheted azt az SMS gatewaynek. Az SMS gateway továbbítja az üzenetedet a mobilhálózatnak vezeték nélküli kapcsolaton vagy az interneten keresztül.

Töltse le a Send-multiple-SMS.php fájlt

A cikkben ismertetett forráskód ingyenesen letölthető, felhasználható és módosítható.
Letöltés: Send_multiple_SMS.zip (3.62Kb)

Mi található a Send-multiple-SMS.js.zip fájlban?

A Send-multiple-SMS.zip fájl tartalmazza az Ozeki.Libs.Rest könyvtárat, amely minden szükséges eszközt biztosít az SMS-ek küldéséhez és fogadásához. A projektben található egy SendMultipleSms fájl is, amely tartalmazza a példakódot, amely bemutatja, hogyan küldj SMS-t. Ez a példakód az alábbiakban látható.

példa projekt több SMS küldésére PHP-val
2. ábra - Send-multiple-SMS könyvtár

Hogyan küldjünk SMS-t PHP-ból (Gyors lépések)

SMS küldése PHP-ból:

  1. Telepítsd az Ozeki SMS Gateway-t
  2. Kapcsold össze az Ozeki SMS Gateway-t a mobilhálózattal
  3. Küldj egy teszt SMS-t az Ozeki GUI-ból
  4. Hozz létre egy HTTP SMS API felhasználót
  5. Indítsd el a Wamp szervert
  6. Töltsd le a fenti példát
  7. Hozd létre az SMS-t egy új Message objektum létrehozásával
  8. Használd a SendSingle metódust az üzeneted elküldéséhez
  9. Olvasd el a HTTP választ
  10. Ellenőrizd a naplókat az SMS gateway-ben

Telepítsd az Ozeki SMS Gateway-t és hozz létre egy HTTP API felhasználót

Ahhoz, hogy SMS-t tudj küldeni PHP-ból, először telepítened kell az Ozeki SMS Gateway-t. Az SMS gateway telepíthető ugyanarra a számítógépre, ahol a PHP kódodat fejleszted. A telepítés után a következő lépés az, hogy összekapcsolod az Ozeki SMS Gateway-t a mobilhálózattal. Küldhetsz egy teszt SMS-t az Ozeki GUI-ból, hogy ellenőrizd, működik-e a mobilhálózati kapcsolatod. A környezet előkészítésének utolsó lépése, hogy létrehozol egy HTTP SMS API felhasználót. Hozz létre egy felhasználót "http_user" felhasználónévvel és "qwe123" jelszóval, hogy a példa módosítás nélkül működjön.

Miután a környezet be van állítva, futtathatod a PHP kódodat.

HTTP API URL SMS küldéséhez PHP-ból

Ahhoz, hogy SMS-t küldj PHP-ból, a PHP-dnak HTTP kérést kell küldenie az SMS gateway felé. Az API URL az alábbiakban látható. Fontos, hogy az IP cím (127.0.0.1) helyére az SMS gateway IP címét írd. Ha az Ozeki SMS Gateway ugyanarra a számítógépre van telepítve, ahol a C# SMS alkalmazás fut, ez lehet 127.0.0.1. Ha másik számítógépre van telepítve, akkor annak a számítógépnek az IP címét kell megadni. 

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

HTTP kérés fejléc SMS küldéséhez PHP-ból

Az SMS üzenetek küldéséhez a következő sorokat kell tartalmaznia a HTTP kérés fejlécének. Vegyük észre, hogy tartalmazunk egy content type és egy Authorization fejlécet. 

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

HTTP kérés SMS küldéséhez PHP-ból

Az SMS beküldéséhez a PHP alkalmazásod egy olyan HTTP kérést fog küldeni, mint az alábbi. Vegyük észre, hogy ez a kérés tartalmaz egy HTTP fejléc részt és egy HTTP törzs részt. A HTTP törzs egy JSON kódolású adatsor. Tartalmazza a címzett számát és az üzenet szövegét. 

HTTP request received from 127.0.0.1:55788
POST /api?action=sendmsg HTTP/1.1
Content-Length: 856
Content-Type: application/json
Accept: */*
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509

{
  "messages": [
    {
      "message_id": "973c88f2-ae30-4b46-a4cd-e497151d38f3",
      "from_connection": null,
      "from_address": null,
      "from_station": null,
      "to_connection": null,
      "to_address": "+36201111111",
      "to_station": null,
      "text": "Hello, World 1!",
      "create_date": "2021-06-16 12:18:04",
      "valid_until": "2021-06-23 12:18:04",
      "time_to_send": "2021-06-16 12:18:04",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    },
    {
      "message_id": "dd910a4f-9172-4f35-9231-8dc83a5fc401",
      "from_connection": null,
      "from_address": null,
      "from_station": null,
      "to_connection": null,
      "to_address": "+36202222222",
      "to_station": null,
      "text": "Hello, World 2!",
      "create_date": "2021-06-16 12:18:04",
      "valid_until": "2021-06-23 12:18:04",
      "time_to_send": "2021-06-16 12:18:04",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    }
  ]
}

HTTP válasz, amit a PHP SMS példa kap

Miután az SMS gateway megkapja ezt a kérést, generál egy HTTP választ. A HTTP válasz tartalmaz egy státuszkódot, amely jelzi, sikeres volt-e az SMS beküldési kérés vagy sem. Ezen kívül visszaad egy JSON kódolású struktúrát is, amely hasznos részleteket nyújt az üzenet beküldéséről. 

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.116 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Wed, 16 Jun 2021 10:04:01 GMT
Server: 10/10.3.116
Transfer-Encoding: chunked

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "Messages queued for delivery.",
  "data": {
    "total_count": 2,
    "success_count": 2,
    "failed_count": 0,
	"messages": [
      {
        "message_id": "63d2303d-9add-44d3-afd6-f27d6b6966ba",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Hello, World 1!",
        "create_date": "2021-06-16 12:18:04",
        "valid_until": "2021-06-23 12:18:04",
        "time_to_send": "2021-06-16 12:18:04",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      },
      {
        "message_id": "f393dd6c-6d6c-4b87-b069-78166a25b894",
        "from_station": "%",
        "to_address": "+36202222222",
        "to_station": "%",
        "text": "Hello, World 2!",
        "create_date": "2021-06-16 12:18:04",
        "valid_until": "2021-06-23 12:18:04",
        "time_to_send": "2021-06-16 12:18:04",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}

Hogyan küldjünk SMS-t PHP-ból a PHP SMS API használatával (Videó útmutató)

Ez a videó bemutatja, hogyan töltsd le és használd a SendSMS php projektet. Miután hozzáadtad a szükséges fájlokat a projektedhez, észreveheted, hogy van egy MessageApi.php nevű fájl. Ez a fájl tartalmazza a MessageApi-t és minden szükséges dolgot az SMS küldéséhez PHP-val.

1. videó - Hogyan küldjünk SMS-t PHP-ból a PHP SMS API használatával (Videó útmutató)

PHP SMS példa: Send_Message.php

3. ábra - Send_Message.php

Hogyan ellenőrizd, hogy az SMS-t elfogadta-e az HTTP felhasználó

Miután elküldted az SMS-t, jó ötlet ellenőrizni az SMS gateway-t, hogy lássad, mit kapott. A naplót az Ozeki SMS Gateway kezelőfelületén az HTTP felhasználó részleteinek megnyitásával ellenőrizheted. Az alábbi videó bemutatja, mire kell figyelni.

2. videó - Hogyan küldjünk SMS-t a fenti PHP kóddal (Videó útmutató)

Hogyan ellenőrizd, hogy az SMS-t elküldte-e a mobilhálózatnak

Az eljárás ellenőrzésének utolsó lépése, hogy megnézzük a mobilhálózati kapcsolat naplóit. Előfordulhat, hogy be kell kapcsolnod a naplózást a kapcsolat beállításaiban, mielőtt elküldöd az üzenetet, hogy lásd a naplókat. Ha a naplózás be van kapcsolva, látni fogod a telefonszámot és az üzenet szövegét, amit küldtél.

3. videó - Hogyan kapcsoljuk be a naplózást az Ozeki SMS Gateway-ben

A naplózás bekapcsolásához a http_user-ben ugyanezeket az utasításokat kell követni.

Összegzés

Ez az útmutató tartalmazza az összes lényeges információt arról, hogyan küldjünk több SMS üzenetet PHP-ból az Ozeki SMS Gateway HTTP REST SMS API-jával. Nagyon hasznosnak fogod találni a PHP SMS API használatát, mert nem csak online SMS szolgáltatókkal működik; működik az android SMS gateway-jel is, lehetővé téve az SMS-ek vezeték nélküli küldését. Ez a szolgáltatás hatékonyabbá teheti az üzenetküldést, mert egyszerre több mobiltelefonra is képes kézbesíteni értékes információkat.

Sok további hasonló útmutatót találhatsz az Ozeki weboldalán, tanuljunk többet! Fedezd fel, hogyan használhatod a PHP-t más célokra is, kezdve az időzített SMS-ek küldésével.

Állítsd be most az Ozeki SMS Gateway-t és gyakorlatba ültesd, amit tanultál!

More information