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, Infobip, Connekio, VectoryLink, Community Ads, Gateway SA, BrandEncode).
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
• Infobip SMS Gateway
• Vectory Link SMS Gateway
• Community Ads SMS Gateway
• Gateway SA SMS Gateway
• BrandEncode 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\Resala\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')
],
'vectory_link' => [
'end_point' => env('VECTORY_LINK_END_POINT'),
'username' => env('VECTORY_LINK_USERNAME'),
'password' => env('VECTORY_LINK_PASSWORD'),
'sender_name' => env('VECTORY_LINK_SENDER_NAME', 'Vectory Link'),
'lang' => env('VECTORY_LINK_LANG', 'E')
],
'community_ads' => [
'end_point' => env('COMMUNITY_ADS_END_POINT', 'https://app.community-ads.com/SendSMSAPI/api/SMSSender/SendSMS'),
'username' => env('COMMUNITY_ADS_USERNAME'),
'password' => env('COMMUNITY_ADS_PASSWORD'),
'sender_name' => env('COMMUNITY_ADS_SENDER_NAME', 'Community Ads'),
'lang' => env('COMMUNITY_ADS_LANG', 'E')
],
'gateway_sa' => [
'end_point' => env('GATEWAYSA_END_POINT', 'http://REST.GATEWAY.SA/api/SendSMS'),
'api_id' => env('GATEWAYSA_API_ID'),
'api_password' => env('GATEWAYSA_API_PASSWORD'),
'sms_type' => env('GATEWAYSA_SMS_TYPE', 'T'),
'encoding' => env('GATEWAYSA_ENCODING', 'T'),
'sender_id' => env('GATEWAYSA_SENDER_ID'),
'templateid' => env('GATEWAYSA_TEMPLATE_ID'),
],
'brandencode' => [
'end_point' => env('BRANDENCODE_END_POINT'),
'username' => env('BRANDENCODE_USERNAME'),
'password' => env('BRANDENCODE_PASSWORD'),
'sender_name' => env('BRANDENCODE_SENDER_NAME', 'Brandencode'),
'lang' => env('BRANDENCODE_LANG', 'E')
],
],
/* |-------------------------------------------------------------------------- | Class Maps |-------------------------------------------------------------------------- | | | This is a list of Classes that maps to the Drivers above. */'map' => [
'vodafone' => VodafoneDriver::class,
'connekio' => ConnekioDriver::class,
'infobip' => InfobipDriver::class,
'vectory_link' => VectoryLinkDriver::class,
'community_ads' => CommunityAdsDriver::class,
'gateway_sa' => GatewaySA::class,
'brandencode' => BrandEncodeDriver::class
],
];

Available Commands:

This adds vodafone environment variables to your .env file.

php artisan resala:make vodafone

This adds connekio environment variables to your .env file.

php artisan resala:make connekio

This adds infobip environment variables to your .env file.

php artisan resala:make infobip

This adds vectory_link environment variables to your .env file.

php artisan resala:make vectory_link

This adds community_ads environment variables to your .env file.

php artisan resala:make community_ads

This adds brandencode environment variables to your .env file.

php artisan resala:make brandencode

This adds gateway_sa environment variables to your .env file.

php artisan resala:make gateway_sa

Usage

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

You can inspect the returned response from your sms provider through:

$response = SMS::to(['010xxxxxxxx', '011xxxxxxxx'])
->message("Hello World")
->send();
$response->success(); // returns bool$response->body(); // returns string

you can optionally change the driver using the via method

SMS::via('vodafone')
->to('010xxxxxxxx')
->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.

useRobustTools\Resala\SMS;
$configFile = __DIR__ . "/config/resala.php";
(newSMS($driver, $configFile))->to(['010995162378', '012345522'])
->message("Hello World")
->send();

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

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

• Mohamed AbdElaziz
• All Contributors

License

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