Ankündigung von v1.0.0 der Nexmo PHP Client Library!

Nach einem heroischen Einsatz von Tim und einiger Arbeit von Michael können wir mit Stolz verkünden, dass wir soeben die Version 1.0 der Nexmo-PHP-Client-Bibliothek markiert haben - es ist nur noch eine composer require entfernt!

Die Technik

Basierend auf Zend Diactoros und Guzzle ist es ein PSR-7-konformer HTTP-Client für die Nexmo-API. Zunächst unterstützt er unsere Kerndienste wie SMS, Voice-Anrufe, Verify und Bereitstellung von virtuellen Numbers und wir werden daran arbeiten, die verbleibenden Produkte im Laufe des nächsten Monats ebenfalls abzudecken.

Egal, ob Sie ein Entwickler sind, der Entitäten und Typ-Hinweise liebt, oder ob Sie lieber alles als Array weitergeben möchten, die Bibliothek hat etwas für Sie. Jede unserer Entitäten implementiert ArrayAccess zum Lesen von Daten und akzeptiert Arrays als Parameter beim Erstellen und Aktualisieren von Entitäten.

$client = new \Nexmo\Client(new Nexmo\Client\Credentials\Basic('API_KEY', 'API_SECRET'));

$message = $client->message()->search('MESSAGE_ID');

// Read the message ID using a getter or using `ArrayAccess`
echo $message->getNetwork().PHP_EOL;
echo $message['network'];

Beispiele

Die Interaktion mit der Nexmo-API ist besonders einfach, wenn Sie unsere PHP-Client-Bibliothek verwenden. Sie können eine SMS senden, einen Sprachanruf tätigen und Verify verwenden, um die Nummer eines Benutzers zu validieren - und das alles in weniger als zehn Zeilen Code!

Wie man eine SMS versendet

$client = new \Nexmo\Client(new Nexmo\Client\Credentials\Basic('API_KEY', 'API_SECRET'));

$client->message()->send([
'from' => '14155550101',
'to' => '14155550100',
'text' => 'A text message sent using the Nexmo SMS API'
]);

So führen Sie einen Voice-Anruf durch

$keypair = new \Nexmo\Client\Credentials\Keypair(file_get_contents(PRIVATE_KEY), APPLICATION_ID);

$client = new \Nexmo\Client($keypair);

$client->calls()->create([
'to' => [['type' => 'phone', 'number' =>'14155550100']],
'from' => ['type' => 'phone', 'number' =>'14155550101'],
'answer_url' => ['https://nexmo-community.github.io/ncco-examples/first_call_talk.json'],
]);

Verwendung von 2FA zur Verifizierung der Identität eines Benutzers

$client = new Nexmo\Client(new Nexmo\Client\Credentials\Basic(API_KEY, API_SECRET));

$verification = $client->verify()->start([
'number' => '14155550100',
'brand' => 'My App'
]);

// The user submits a form via POST that contains the
// code they received in the `verification_code` input
$client->verify()->check($verification, $_POST['verification_code']);

Bonuspunkte

Wenn Sie ein Laravel-Benutzer sind, haben wir ein ganz besonderes Schmankerl für Sie. Zusätzlich zu unserer eigenständigen Bibliothek haben wir nexmo/laravel die ein Laravel-Service-Provider für den Nexmo-PHP-Client ist. Wenn Sie Laravel 5.5 oder höher verwenden, wird sich die Bibliothek automatisch als Provider registrieren, so dass Sie die Fassade sofort nutzen können.

Nach der Installation von nexmo/laravel und Ihren API-Schlüssel und Ihr Geheimnis über .envinstalliert und konfiguriert haben, ist das Versenden einer SMS so einfach wie möglich:

Nexmo::message()->send([
'to' => '14155550100',
'from' => '14155550101',
'text' => 'Using the facade to send a message.'
]);

Beteiligen Sie sich!

Egal, ob Sie Nexmo über SMS-Benachrichtigungen in Laravel eingesetzt haben (ja, wir können das!), ein riesiges Logistiksystem gebaut haben oder irgendetwas dazwischen; wir würden gerne davon hören. Noch besser ist es, wenn es Open Source ist und wir es als Beispiel dafür verwenden können, wie man die Leistung von Nexmo nutzen kann, um die Arbeit zu erledigen.

Wenn Sie daran interessiert sind, sich an der Entwicklung der Client-Bibliothek zu beteiligen, ist es so einfach, wie einen Anwendungsfall zu finden, den wir noch nicht unterstützen, und eine Anfrage zu stellen. Wir können zusammenarbeiten, um die Unterstützung zu spezifizieren und in den Client zu integrieren (wir helfen Ihnen sogar beim Schreiben der Tests!).