leadthread/laravel-sms

3.0.0-beta.14 2017-08-15 21:52 UTC

Requires

• php: ^5.5.9|^7.0
• illuminate/bus: ^5.2
• illuminate/contracts: ^5.2
• illuminate/queue: ^5.2
• illuminate/support: ^5.2

Requires (Dev)

• bandwidth/catapult: ^0.8.2
• orchestra/testbench: ^3.2
• phpunit/phpunit: ^4.8|^5.0
• plivo/plivo-php: ^1.1
• twilio/sdk: ^5.1

Suggests

• bandwidth/catapult: ^0.8.2
• plivo/plivo-php: ^1.1
• twilio/sdk: ^5.1

MIT

• Tyler Arbon

• sms
• twilio
• laravel
• plivo
• tylercd100
• leadthread

README

Please read the README for the latest stable branch v2.1.2

Laravel SMS is a simple Laravel 5 package for sending messages to different SMS services.

Currently supported:

• Plivo
• Twilio

Installation

Install via composer - In the terminal:

composer require leadthread/laravel-sms

Install Plivo or Twilio SDK

composer require plivo/plivo-php:^1.1
# or
composer require twilio/sdk:^4.10
# or
composer require bandwidth/catapult:^0.8.2

Now add the following to the providers array in your config/app.php

LeadThread\Sms\Providers\SmsServiceProvider::class

and this to the aliases array in config/app.php

"Sms" => "LeadThread\Sms\Facades\Sms",

Then you will need to run these commands in the terminal in order to copy the config file

php artisan vendor:publish

Usage

First you must change your config file located at config/sms.php with your proper API credentials.

Sending Messages

You can simply send a message like this:

# Send one text
$message  = "Hello Phone!";
$to       = "[phone]";
$from     = "[phone]";
$response = Sms::send($message,$to,$from);

# Send many texts
$message  = "Hello Phone!";
$to       = ["[phone]","[phone]","[phone]"];
$from     = "[phone]";
$response = Sms::sendMany($message,$to,$from);

# Send many texts with different messages
$items = [
  ["msg"=>"Hello Rick!", "to"=>"[phone]","from"=>"[phone]"],
  ["msg"=>"Hello Tyler!","to"=>"[phone]","from"=>"[phone]"],
  ["msg"=>"Hello Karla!","to"=>"[phone]","from"=>"[phone]"],
];
$response = Sms::sendArray($items);

Dont forget to add this to the top of the file

//If you updated your aliases array in "config/app.php"
use Sms;
//or if you didnt...
use LeadThread\Sms\Facades\Sms;

Buying and Selling phone numbers

$areacode = '435';
//Search for a number to buy
//The response is different for each SMS service provider. This example shows Plivo.
$response = Sms::searchNumber($areacode);
$number = $response['response']['objects'][0]['number'];

//Buy the number
Sms::buyNumber($number);

//Unrent the number
Sms::sellNumber($number);

Contributing

Contributions are always welcome! If you would like to have another service added to the list please request it by opening up an issue or sending a pull request