2amigos/yii2-nexmo-library

The Nexmo library for the Yii framework

1.0.1 2017-06-09 08:41 UTC

README

Latest Version Software License Build Status Coverage Status Quality Score Total Downloads

Nexmo Library allows Yii programmers to use the Restful API offered by Mobile Messaging provider Nexmo.

Nexmo is a cloud-based SMS API that lets you send and receive high volume of messages at wholesale rates.

Installation

The preferred way to install this extension is through composer.

Either run

$ composer require 2amigos/yii2-nexmo-library:~1.0

or add

"2amigos/yii2-nexmo-library": "~1.0"

to the require section of your composer.json file.

Usage

First you have to create your [Nexmo account](Nexmo API credentials) and get your API_KEY and API_SECRET.

// to send an sms message
$sms = new \dosamigos\nexmo\Sms(['key' => 'API_KEY', 'secret' => 'API_SECRET', 'from' => 'SENDERID']);

// lets call the API to get a json response
$sms->format = 'json';

// send a message with an optional parameter (see Nexmo doc for more optional parameters)
$response = $sms->sendText('RECIPIENTSNUMBER', 'Hello World!', ['clientRef' => 'YOURCLIENTREF']);

// if a response expects a JSON object, it will return as an array, if format was a XML, it will return an object.
echo $response['message-count']; // the number of parts the message was split into

Testing

$ ./vendor/bin/phpunit

Contributing

Please see CONTRIBUTING for details.

Credits

License

The BSD License (BSD). Please see License File for more information.

687474703a2f2f7777772e67726176617461722e636f6d2f6176617461722f35353336333339346437323934356666376564333132353536656330343165302e706e67
web development has never been so fun
www.2amigos.us