PHP & Laravel SMS Gateway Integration Package

Resala is a PHP & Laravel Package, (Designed to add support to your laravel or just native php app for sending SMS using local operators in the MENA region Like Vodafone, Infopib, Conneckio).
Resala not just tied to use inside Laravel you can hook it up in any php code

Supported Providers

Vodafone SMS Gateway
Connekio SMS Gateway
InfoPib SMS Gateway

Installation

You can install the package via composer:

composer require robust-tools/resala

Laravel Usage.

Configure

publish the config file with:

php artisan vendor:publish --provider="RobustTools\SMS\SMSServiceProvider" --tag="config"

This is the contents of the published config file:

return [

    /*
     * You can specify a default service provider driver here.
     * If it is not set we'll use vodafone as the default driver.
     */
    'default' => env('SMS_DRIVER', 'vodafone'),

    /*
    |--------------------------------------------------------------------------
    | List of sms drivers
    |--------------------------------------------------------------------------
    |
    | This is a list of possible sms gateways drivers
    |
    */

    'drivers' => [

        'vodafone' => [
            'end_point' => env('VODAFONE_END_POINT'),
            'account_id' => env('VODAFONE_ACCOUNT_ID'),
            'password' => env('VODAFONE_PASSWORD'),
            'secure_hash' => env('VODAFONE_SECURE_HASH'),
            'sender_name' => env('VODAFONE_SENDER_NAME', 'Vodafone')
        ],

        'connekio' => [
            'single_sms_endpoint' => env('SINGLE_SMS_ENDPOINT'),
            'batch_sms_endpoint' => env('BATCH_SMS_ENDPOINT'),
            'username' => env('CONNEKIO_USERNAME'),
            'password' => env('CONNEKIO_PASSWORD'),
            'account_id' => env('CONNEKIO_ACCOUNT_ID'),
            'sender_name' => env('CONNEKIO_SENDER_NAME')
        ],

        'infobip' => [
            'end_point' => env('INFOBIP_END_POINT'),
            'username' => env('INFOBIP_USERNAME'),
            'password' => env('INFOBIP_PASSWORD'),
            'sender_name' => env('INFOBIP_SENDER_NAME', 'Infobip')
        ],
    ],

    /*
    |--------------------------------------------------------------------------
    | Class Maps
    |--------------------------------------------------------------------------
    |
    |
    | This is a list of Classes that maps to the Drivers above.
    */
    'map' => [
        'vodafone' => VodafoneDriver::class,
        'connekio' => ConnekioDriver::class,
        'infobip' => InfobipDriver::class
    ],
];

php artisan resala:make vodafone

This adds vodafone environment variables to your .env file.

php artisan resala:make connekio

This adds connekio environment variables to your .env file.

php artisan resala:make infobip

This adds infobip environment variables to your .env file.

Usage

SMS::to('010xxxxxxxx')
    ->message("Hello World")
    ->send();

SMS::to(['010xxxxxxxx', '011xxxxxxxx'])
    ->message("Hello World")
    ->send();

you can optionally change the driver using the via method

SMS::via('connekio')
    ->to('010xxxxxxxx')
    ->message("Hello World")
    ->send();

SMS::via('infobip')
    ->to('2012xxxxxxxx')
    ->message("Hello World")
    ->send();

#Outside Laravel You need to add a config file named resala.php in your project directory the contents of the config file must match the schema of the package config file you can find it HERE. just replace the env(values) with your driver config values.

##Usage

use RobustTools\SMS\SMSManager;

$configFile = __DIR__ . "/config/resala.php";

(new SMSManager($configFile))->to(['010995162378', '012345522'])
         ->message("Hello World")
         ->send();

IF no configuration file is being passed a ConfigFileNotFoundException will be thrown.

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email mohabdelaziz95@gmail.com instead of using the issue tracker.

Credits

License

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

MeeGz/Resala