SMS-Versand von PHP aus

Der einfachste Weg, SMS von PHP aus zu versenden, ist die Verwendung der integrierten HTTP/Rest-SMS-API von Ozeki SMS Gateway. Wenn Sie diese API verwenden, senden Sie SMS-Nachrichten, indem Sie eine HTTP-Post-Anfrage an das SMS-Gateway stellen. Die HTTP-Post-Anfrage enthält eine Nachricht im JSON-Format. Das SMS-Gateway sendet diese SMS an den Empfänger und gibt eine HTTP-200-OK-Antwort auf Ihre Anfrage zurück.

SMS-Versand von PHP aus
Abbildung 1 - SMS-Versand von PHP aus

PHP-Code zum Senden von SMS an Mobiltelefone

Das folgende PHP-SMS-Codebeispiel zeigt, wie Sie SMS mit der HTTP-Rest-SMS-API von Ozeki SMS Gateway unter Verwendung der PHP Ozeki.Libs.Rest-Bibliothek senden können. Diese Bibliothek wird Ihnen kostenlos zur Verfügung gestellt und kann in Ihren Projekten verwendet und modifiziert werden.

SendSMS.cs 

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

		$configuration = new Configuration();
		
		$configuration -> Username = "http_user";
		$configuration -> Password = "qwe123";
		$configuration -> ApiUrl = "http://192.168.0.113:9509/api";
		
		$msg = new Message();
		
		$msg -> ToAddress = "+36201111111";
		$msg -> Text = "Hallo, Welt!";
			
		$api = new MessageApi($configuration);
		
		$result = $api -> SendSingle($msg);	
		
		echo strval($result);
}

Verwendung des PHP-SMS-Beispiels:

Dieses PHP-SMS-Beispiel kann in jeder PHP-Anwendung verwendet werden. Um es zu nutzen, müssen Sie den MessageApi-Ordner zu Ihrem Projekt hinzufügen. Sie können die Message-Klasse verwenden, um die SMS zu erstellen, und die MessageApi-Klasse, um die SMS an das SMS-Gateway zu senden. Das SMS-Gateway leitet Ihre Nachricht entweder über eine drahtlose Verbindung oder über das Internet an das Mobilfunknetz weiter.

SendSMS.php herunterladen

Der in diesem Artikel erklärte Quellcode kann kostenlos heruntergeladen, verwendet und modifiziert werden.
Download: SendSMS.zip (5,9 KB)

Was befindet sich in der SendSMS.zip-Datei?

Die SendSMS.zip-Datei enthält die Ozeki.Libs.Rest.Php-Bibliothek, die Ihnen alle notwendigen Werkzeuge zum Senden und Empfangen von SMS-Nachrichten bietet. Außerdem finden Sie im Zip-Archiv das SendSMS-Projekt mit dem Beispielcode, der Ihnen zeigt, wie Sie eine SMS senden können. Dieser Beispielcode ist unten aufgeführt.

Abbildung 2 - Inhalt von SendSMS.zip

SMS-Versand von PHP aus (Schnelle Schritte)

So senden Sie SMS von PHP aus:

  1. Installieren Sie Ozeki SMS Gateway
  2. Verbinden Sie Ozeki SMS Gateway mit dem Mobilfunknetz
  3. Senden Sie eine Test-SMS über die Ozeki-Oberfläche
  4. Erstellen Sie einen HTTP-SMS-API-Benutzer
  5. Starten Sie den Wamp-Server
  6. Laden Sie das obige Beispiel herunter
  7. Erstellen Sie die SMS durch Erstellen eines neuen Message-Objekts
  8. Verwenden Sie die SendSingle-Methode, um Ihre Nachricht zu senden
  9. Lesen Sie die HTTP-Antwort
  10. Überprüfen Sie die Protokolle im SMS-Gateway

Installieren Sie Ozeki SMS Gateway und erstellen Sie einen HTTP-API-Benutzer

Um SMS von PHP aus senden zu können, müssen Sie zunächst Ozeki SMS Gateway installieren. Das SMS-Gateway kann auf demselben Computer installiert werden, auf dem Sie Ihren PHP-Code entwickeln. Nach der Installation besteht der nächste Schritt darin, Ozeki SMS Gateway mit dem Mobilfunknetz zu verbinden. Sie können eine Test-SMS über die Ozeki-Oberfläche senden, um zu überprüfen, ob Ihre Mobilfunknetzverbindung funktioniert. Der letzte Schritt zur Vorbereitung Ihrer Umgebung ist die Erstellung eines HTTP-SMS-API-Benutzerkontos. Erstellen Sie einen Benutzer mit dem Benutzernamen "http_user" und dem Passwort "qwe123", damit das Beispiel ohne Änderungen funktioniert.

Nachdem die Umgebung eingerichtet ist, können Sie Ihren PHP-Code ausführen.

HTTP-API-URL zum Senden von SMS von PHP aus

Um SMS von PHP aus zu senden, muss Ihre PHP-Anwendung eine HTTP-Anfrage an das SMS-Gateway stellen. Die API-URL wird unten angezeigt. Beachten Sie, dass die IP-Adresse (127.0.0.1) durch die IP-Adresse Ihres SMS-Gateways ersetzt werden sollte. Wenn Ozeki SMS Gateway auf demselben Computer installiert ist, auf dem die C#-SMS-Anwendung läuft, kann dies 127.0.0.1 sein. Wenn es auf einem anderen Computer installiert ist, sollte es die IP-Adresse dieses Computers sein. 

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

HTTP-Anfrageheader zum Senden von SMS von PHP aus

Um die SMS-Nachrichten zu senden, müssen Sie die folgenden Zeilen als Header in die HTTP-Anfrage aufnehmen. Beachten Sie, dass wir einen Content-Type-Header und einen Authorization-Header einfügen. 

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

HTTP-Anfrage zum Senden von SMS von PHP aus

Um die SMS zu übermitteln, sendet Ihre PHP-Anwendung eine HTTP-Anfrage ähnlich der unten gezeigten. Beachten Sie, dass diese Anfrage einen HTTP-Header-Teil und einen HTTP-Body-Teil enthält. Der HTTP-Body ist eine JSON-kodierte Datenzeichenkette. Sie enthält die Nummer des Empfängers und den Text der Nachricht. 

HTTP-Anfrage empfangen von 192.168.0.113:62101
POST /api?action=sendmsg HTTP/1.1
Content-Length: 433
Content-Type: application/json
Accept: */*
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 192.168.0.113:9509

{
  "messages": [
    {
      "message_id": "f259f9de-bc27-4794-8d2b-691af76b551b",
      "from_connection": null,
      "from_address": null,
      "from_station": null,
      "to_connection": null,
      "to_address": "+36201111111",
      "to_station": null,
      "text": "Hallo, Welt!",
      "create_date": "2021-06-15 15:10:16",
      "valid_until": "2021-06-22 15:10:16",
      "time_to_send": "2021-06-15 15:10:16",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    }
  ]
}

HTTP-Antwort, die vom PHP-SMS-Beispiel empfangen wurde

Sobald das SMS-Gateway diese Anfrage empfängt, generiert es eine HTTP-Antwort. Die HTTP-Antwort enthält einen Statuscode, der angibt, ob die SMS-Sendeanfrage erfolgreich war oder nicht. Es wird auch eine JSON-kodierte Struktur zurückgegeben, die Ihnen nützliche Details über die Übermittlung der Nachricht liefert. 

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.118 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Mon, 14 Jun 2021 07:43:45 GMT
Server: 10/10.3.118
Transfer-Encoding: chunked

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "Messages queued for delivery.",
  "data": {
    "total_count": 1,
    "success_count": 1,
    "failed_count": 0,
    "messages": [
      {
        "message_id": "a451446c-db80-4009-b51d-31d0675e28c4",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Hello, World!",
        "create_date": "2021-06-15 15:10:16",
        "valid_until": "2021-06-22 15:10:16",
        "time_to_send": "2021-06-15 15:10:16",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}

Wie man SMS von PHP aus mit der PHP-SMS-API sendet (Video-Tutorial)

Dieses Video zeigt Ihnen, wie Sie das SendSMS-PHP-Projekt herunterladen und verwenden. Sobald Sie die benötigten Dateien zu Ihrem Projekt hinzugefügt haben, werden Sie feststellen, dass es eine Datei namens MessageApi.php gibt. Dies ist die Datei, die die MessageApi und alles, was Sie zum Senden einer SMS mit PHP benötigen, enthält.

Video 1 - Wie man das Beispielprojekt herunterlädt und ausführt

PHP-SMS-Beispiel: Send_Message.php

Abbildung 2 - Send_Message.php

Wie man überprüft, ob die SMS vom HTTP-Benutzer akzeptiert wurde

Nachdem die SMS übermittelt wurde, ist es eine gute Idee, Ihr SMS-Gateway zu überprüfen, um zu sehen, was es empfangen hat. Sie können das Protokoll überprüfen, indem Sie die Details des HTTP-Benutzers in der Ozeki SMS Gateway Management-Konsole öffnen. Das folgende Video zeigt Ihnen, worauf Sie achten müssen.

Video 2 - SMS mit dem oben gezeigten PHP-Code senden

Wie man überprüft, ob die SMS an das Mobilfunknetz gesendet wurde

Der letzte Schritt zur Überprüfung des Verfahrens besteht darin, die Protokolle der Mobilfunknetzverbindung zu überprüfen. Möglicherweise müssen Sie die Protokollierung in der Konfiguration der Verbindung aktivieren, bevor Sie die Nachricht senden, um die Protokolle zu sehen. Wenn die Protokollierung aktiviert ist, sehen Sie die Telefonnummer und den Text der gesendeten Nachricht.

Video 3 - Wie man die Protokollierung im Ozeki SMS Gateway aktiviert

Um die Protokollierung im http_user zu aktivieren, müssen Sie die gleichen Anweisungen befolgen.

Abschließende Gedanken

Diese Anleitung enthielt alle notwendigen Informationen, wie Sie SMS-Nachrichten von PHP aus mit der HTTP-REST-SMS-API des Ozeki SMS Gateways senden können. Diese Lösung erfordert eine HTTP-Benutzerverbindung im Ozeki SMS Gateway, wodurch sie eine sehr zuverlässige Verbindung bietet, die mit erstaunlicher Geschwindigkeit arbeitet. Dieser Dienst kann Ihre Organisation effizienter machen, da er Ihnen ermöglicht, wichtige Informationen, die per E-Mail verfügbar sind, an Mobiltelefone zu liefern und so Arbeitsabläufe zu beschleunigen.

Es gibt noch viele weitere Artikel, die Ihnen helfen sollen, also stellen Sie sicher, dass Sie sie lesen. Beginnen Sie mit dem Artikel Wie man mehrere SMS von PHP aus sendet und vervielfachen Sie Ihre Möglichkeiten.

Beginnen Sie jetzt mit der Verwendung des Ozeki SMS Gateways! Alles ist vorhanden, um es in wenigen Minuten einzurichten und zum Laufen zu bringen.

More information