├── .env.example
├── config
    └── sms.php
└── src
    ├── Contracts
        └── SMS.php
    ├── Drivers
        ├── Driver.php
        ├── NexmoDriver.php
        ├── NullDriver.php
        └── TwilioDriver.php
    ├── Exceptions
        └── SmsException.php
    ├── Facade
        └── Sms.php
    ├── SmsManager.php
    └── SmsServiceProvider.php


/.env.example:
--------------------------------------------------------------------------------
1 | NEXMO_KEY=
2 | NEXMO_SECRET=
3 | NEXMO_SMS_FROM=
4 | 
5 | TWILIO_KEY=
6 | TWILIO_SECRET=
7 | TWILIO_SMS_FROM=


--------------------------------------------------------------------------------
/config/sms.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | return [
 4 | 
 5 |     /*
 6 |     |--------------------------------------------------------------------------
 7 |     | The default SMS Driver
 8 |     |--------------------------------------------------------------------------
 9 |     | 
10 |     | The default sms driver to use as a fallback when no driver is specified
11 |     | while using the SMS component.
12 |     |
13 |     */
14 |     'default' => env('SMS_DRIVER', 'nexmo'),
15 | 
16 |     /*
17 |     |--------------------------------------------------------------------------
18 |     | Nexmo Driver Configuration
19 |     |--------------------------------------------------------------------------
20 |     |
21 |     | We specify key, secret, and the number messages will be sent from.
22 |     |
23 |     */
24 |     'nexmo' => [
25 |         'key' => env('NEXMO_KEY', ''),
26 |         'secret' => env('NEXMO_SECRET', ''),
27 |         'from' => env('NEXMO_SMS_FROM', '')
28 |     ],
29 | 
30 |     /*
31 |     |--------------------------------------------------------------------------
32 |     | Twilio Driver Configuration
33 |     |--------------------------------------------------------------------------
34 |     |
35 |     | We specify key, secret, and the number messages will be sent from.
36 |     |
37 |     */
38 |     'twilio' => [
39 |         'key' => env('TWILIO_KEY', ''),
40 |         'secret' => env('TWILIO_SECRET', ''),
41 |         'from' => env('TWILIO_SMS_FROM', '')
42 |     ],
43 | ];


--------------------------------------------------------------------------------
/src/Contracts/SMS.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Components\Sms\Contracts;
 4 | 
 5 | interface SMS
 6 | {
 7 |     /**
 8 |      * Send the given message to the given recipient.
 9 |      * 
10 |      * @return mixed
11 |      */
12 |     public function send();
13 | }


--------------------------------------------------------------------------------
/src/Drivers/Driver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Components\Sms\Drivers;
 4 | 
 5 | use Illuminate\Support\Arr;
 6 | use App\Components\Sms\Contracts\SMS;
 7 | use App\Components\Sms\Exceptions\SmsException;
 8 | 
 9 | abstract class Driver implements SMS
10 | {
11 |     /**
12 |      * The recipient of the message.
13 |      * 
14 |      * @var string
15 |     */
16 |     protected $recipient;
17 | 
18 |     /**
19 |      * The message to send.
20 |      * 
21 |      * @var string
22 |     */
23 |     protected $message;
24 | 
25 |     /**
26 |      * {@inheritdoc}
27 |      */
28 |     abstract public function send();
29 | 
30 |     /**
31 |      * Set the recipient of the message.
32 |      * 
33 |      * @param string  $recipient
34 |      * 
35 |      * @throws \App\Components\Sms\Exceptions\SmsException
36 |      * 
37 |      * @return $this
38 |     */
39 |     public function to(string $recipient)
40 |     {
41 |         throw_if(is_null($recipient), SmsException::class, 'Recipients cannot be empty');
42 | 
43 |         $this->recipient = $recipient;
44 | 
45 |         return $this;
46 |     }
47 | 
48 |     /**
49 |      * Set the content of the message.
50 |      * 
51 |      * @param string  $message
52 |      * 
53 |      * @throws \App\Components\Sms\Exceptions\SmsException
54 |      * 
55 |      * @return $this
56 |     */
57 |     public function content(string $message)
58 |     {
59 |         throw_if(empty($message), SmsException::class, 'Message text is required');
60 | 
61 |         $this->message = $message;
62 | 
63 |         return $this;
64 |     }
65 | }


--------------------------------------------------------------------------------
/src/Drivers/NexmoDriver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Components\Sms\Drivers;
 4 | 
 5 | use Nexmo\Client as NexmoClient;
 6 | 
 7 | class NexmoDriver extends Driver
 8 | {
 9 |     /**
10 |      * The Nexmo client.
11 |      * 
12 |      * @var \Nexmo\Client
13 |     */
14 |     protected $client;
15 | 
16 |     /**
17 |      * The phone number this sms should be sent from.
18 |      *
19 |      * @var string
20 |      */
21 |     protected $from;
22 | 
23 |     /**
24 |      * Create a new Nexmo driver instance.
25 |      *
26 |      * @param  \Nexmo\Client  $nexmo
27 |      * @param  string  $from
28 |      * @return void
29 |     */
30 |     public function __construct(NexmoClient $nexmo, $from)
31 |     {
32 |         $this->client = $nexmo;
33 |         $this->from = $from;
34 |     }
35 | 
36 |     /**
37 |      * {@inheritdoc}
38 |     */
39 |     public function send()
40 |     {
41 |         return $this->client->message()->send([
42 |             'type' => 'text',
43 |             'from' => $this->from,
44 |             'to' => $this->recipient,
45 |             'text' => trim($this->message)
46 |         ]);
47 |     }
48 | }


--------------------------------------------------------------------------------
/src/Drivers/NullDriver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Components\Sms\Drivers;
 4 | 
 5 | class NullDriver extends Driver
 6 | {
 7 |     /**
 8 |      * {@inheritdoc}
 9 |     */
10 |     public function send()
11 |     {
12 |         return [];
13 |     }
14 | }


--------------------------------------------------------------------------------
/src/Drivers/TwilioDriver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Components\Sms\Drivers;
 4 | 
 5 | use Twilio\Rest\Client as TwilioClient;
 6 | 
 7 | class TwilioDriver extends Driver
 8 | {
 9 |     /**
10 |      * The Twilio client.
11 |      * 
12 |      * @var \Twilio\Rest\Client
13 |     */
14 |     protected $client;
15 | 
16 |     /**
17 |      * The phone number this sms should be sent from.
18 |      *
19 |      * @var string
20 |      */
21 |     protected $from;
22 | 
23 |     /**
24 |      * Create a new Twilio driver instance.
25 |      *
26 |      * @param  \Twilio\Rest\Client  $twilio
27 |      * @param  string  $from
28 |      * @return void
29 |     */
30 |     public function __construct(TwilioClient $twilio, $from)
31 |     {
32 |         $this->client = $twilio;
33 |         $this->from = $from;
34 |     }
35 | 
36 |     /**
37 |      * {@inheritdoc}
38 |     */
39 |     public function send()
40 |     {
41 |         return $this->client->messages->create(
42 |             $this->recipient, [
43 |                 'from' => $this->from,
44 |                 'body' => trim($this->message)
45 |             ]
46 |         );
47 |     }
48 | }


--------------------------------------------------------------------------------
/src/Exceptions/SmsException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Components\Sms\Exceptions;
 4 | 
 5 | use Exception;
 6 | 
 7 | class SmsException extends Exception
 8 | {
 9 | 
10 | }


--------------------------------------------------------------------------------
/src/Facade/Sms.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Components\Sms\Facade;
 4 | 
 5 | use Illuminate\Support\Facades\Facade;
 6 | 
 7 | class Sms extends Facade
 8 | {
 9 |     /**
10 |      * Get the registered name of the component.
11 |      *
12 |      * @return string
13 |      *
14 |      * @throws \RuntimeException
15 |      */
16 |     protected static function getFacadeAccessor()
17 |     {
18 |         return 'sms';
19 |     }
20 | }


--------------------------------------------------------------------------------
/src/SmsManager.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace App\Components\Sms;
  4 | 
  5 | use Illuminate\Support\Manager;
  6 | use Nexmo\Client as NexmoClient;
  7 | use Twilio\Rest\Client as TwilioClient;
  8 | use App\Components\Sms\Drivers\NullDriver;
  9 | use App\Components\Sms\Drivers\NexmoDriver;
 10 | use App\Components\Sms\Drivers\TwilioDriver;
 11 | use Nexmo\Client\Credentials\Basic as NexmoBasicCredentials;
 12 | 
 13 | class SmsManager extends Manager
 14 | {
 15 |     /**
 16 |      * Get a driver instance.
 17 |      *
 18 |      * @param  string|null  $name
 19 |      * @return mixed
 20 |      */
 21 |     public function channel($name = null)
 22 |     {
 23 |         return $this->driver($name);
 24 |     }
 25 | 
 26 |     /**
 27 |      * Create a Nexmo SMS driver instance.
 28 |      *
 29 |      * @return \App\Components\Sms\Drivers\NexmoDriver
 30 |      */
 31 |     public function createNexmoDriver()
 32 |     {
 33 |         return new NexmoDriver(
 34 |             $this->createNexmoClient(),
 35 |             $this->app['config']['sms.nexmo.from']
 36 |         );
 37 |     }
 38 | 
 39 |     /**
 40 |      * Create a Twilio SMS driver instance.
 41 |      *
 42 |      * @return \App\Components\Sms\Drivers\TwilioDriver
 43 |      */
 44 |     public function createTwilioDriver()
 45 |     {
 46 |         return new TwilioDriver(
 47 |             $this->createTwilioClient(),
 48 |             $this->app['config']['sms.twilio.from']
 49 |         );
 50 |     }
 51 | 
 52 |     /**
 53 |      * Create the Nexmo client.
 54 |      * 
 55 |      * @return \Nexmo\Client
 56 |     */
 57 |     protected function createNexmoClient()
 58 |     {
 59 |         return new NexmoClient(
 60 |             new NexmoBasicCredentials(
 61 |                 $this->app['config']['sms.nexmo.key'],
 62 |                 $this->app['config']['sms.nexmo.secret']
 63 |             )
 64 |         );
 65 |     }
 66 | 
 67 |     /**
 68 |      * Create the Twilio client.
 69 |      * 
 70 |      * @return \Twilio\Rest\Client
 71 |     */
 72 |     protected function createTwilioClient()
 73 |     {
 74 |         return new TwilioClient(
 75 |             $this->app['config']['sms.twilio.key'],
 76 |             $this->app['config']['sms.twilio.secret']
 77 |         );
 78 |     }
 79 | 
 80 | 
 81 |     /**
 82 |      * Create a Null SMS driver instance.
 83 |      *
 84 |      * @return \App\Components\Sms\Drivers\NullDriver
 85 |      */
 86 |     public function createNullDriver()
 87 |     {
 88 |         return new NullDriver;
 89 |     }
 90 | 
 91 |     /**
 92 |      * Get the default SMS driver name.
 93 |      *
 94 |      * @return string
 95 |      */
 96 |     public function getDefaultDriver()
 97 |     {
 98 |         return $this->app['config']['sms.default'] ?? 'null';
 99 |     }
100 | }


--------------------------------------------------------------------------------
/src/SmsServiceProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Providers;
 4 | 
 5 | use App\Components\Sms\SmsManager;
 6 | use Illuminate\Support\ServiceProvider;
 7 | 
 8 | class SmsServiceProvider extends ServiceProvider
 9 | {
10 |     /**
11 |      * Indicates if loading of the provider is deferred.
12 |      *
13 |      * @var bool
14 |      */
15 |     protected $defer = true;
16 | 
17 |     /**
18 |      * Register any application services.
19 |      *
20 |      * @return void
21 |      */
22 |     public function register()
23 |     {
24 |         $this->app->singleton('sms', function ($app) {
25 |             return new SmsManager($app);
26 |         });
27 |     }
28 | 
29 |     /**
30 |      * Get the services provided by the provider.
31 |      *
32 |      * @return array
33 |      */
34 |     public function provides()
35 |     {
36 |         return ['sms'];
37 |     }
38 | }


--------------------------------------------------------------------------------