PHPackages rahulhaque/adn-sms - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. rahulhaque/adn-sms ActiveLibrary rahulhaque/adn-sms ================== ADN SMS gateway API package for Laravel. v1.1.2(3y ago)73532MITPHPPHP ^7.1|^8.0 Since Feb 7Pushed 3y ago1 watchersCompare [ Source](https://github.com/rahulhaque/adn-sms-laravel)[ Packagist](https://packagist.org/packages/rahulhaque/adn-sms)[ Docs](https://github.com/rahulhaque/adn-sms-laravel)[ RSS](/packages/rahulhaque-adn-sms/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (4)Dependencies (3)Versions (6)Used By (0) ADN SMS Laravel =============== [](#adn-sms-laravel) [![Latest Version on Packagist](https://camo.githubusercontent.com/8c1d5bdefb2df4e896042a496ec414da7f5c03a8f85a2770e79861e0a5f3f3f3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726168756c68617175652f61646e2d736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/rahulhaque/adn-sms)[![Total Downloads](https://camo.githubusercontent.com/90a73f46228de1df6385571ebfaffbc6bcf19aa02bd103ce7a15d461d98831fa/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f726168756c68617175652f61646e2d736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/rahulhaque/adn-sms) ADN SMS gateway API package for Laravel. Installation ------------ [](#installation) You can install the package via composer in your Laravel or Lumen application. ``` composer require rahulhaque/adn-sms ``` ### Laravel [](#laravel) Publish the configuration file `config/adn-sms.php` where you can tweak some default options. ``` php artisan vendor:publish --provider="RahulHaque\AdnSms\AdnSmsServiceProvider" ``` Define your `ADN_SMS_KEY` and `ADN_SMS_SECRET` in the `.env` file or update the `config/adn-sms.php` file of your application. ### Lumen [](#lumen) Laravel comes pre-installed with [Guzzle HTTP Client](https://docs.guzzlephp.org/en/stable/) however Lumen does not. Install guzzle as this package depends on it to make the API calls. ``` composer require guzzlehttp/guzzle ``` Enable use of `Facades` in your Lumen application by uncommenting the line `$app->withFacades();` call in the `bootstrap/app.php` file. Register the service provider in the **Register Service Providers** section of the `bootstrap/app.php` file. ``` $app->register(RahulHaque\AdnSms\AdnSmsServiceProvider::class); ``` Define your `ADN_SMS_KEY` and `ADN_SMS_SECRET` in the `.env` file of your application. Or publish the config by copying the `vendor/rahulhaque/adn-sms/config/adn-sms.php` file to `config/adn-sms.php` of your Lumen application. Create the directory if doesn't exist. Register the config in the `bootstrap/app.php` file in the **Register Configuration Files** section. ``` $app->configure('adn-sms'); ``` Configuration ------------- [](#configuration) First have a look at the `./config/adn-sms.php` to know about all the options available out of the box. Some important ones are mentioned below. **Service Enable/Disable** You can easily turn off the whole service and any API calls from the config file. Comes in handy if the APIs are down or ongoing maintenance. Remember, if you set `enabled` to `false` in the configuration file, response body will always be empty string `$response->body() = ""`. Usage ----- [](#usage) ### Single SMS [](#single-sms) **Send single SMS to single recipient.** ``` use RahulHaque\AdnSms\Facades\AdnSms; class SomeController { /** * Make request and return response * * @return \Illuminate\Http\Client\Response * @throws \Throwable */ public function someFunction() { $response = AdnSms::to('01XXXXXXXXX') ->message('Send SMS Test.') ->send(); return $response->json(); } } ``` ### OTP SMS [](#otp-sms) **Send OTP SMS to single recipient.** ``` use RahulHaque\AdnSms\Facades\AdnSms; class SomeController { /** * Make request and return response * * @return \Illuminate\Http\Client\Response * @throws \Throwable */ public function someFunction() { $response = AdnSms::otp('01XXXXXXXXX') ->message('Send OTP SMS Test.') ->send(); return $response->json(); } } ``` ### Bulk SMS [](#bulk-sms) **Send single SMS to multiple recipients.** Bulk SMS sending requires `campaignTitle()` as mandatory. ``` use RahulHaque\AdnSms\Facades\AdnSms; class SomeController { /** * Make request and return response * * @return \Illuminate\Http\Client\Response * @throws \Throwable */ public function someFunction() { $response = AdnSms::bulk(['01XXXXXXXXX', '02XXXXXXXXX']) ->campaignTitle('Bulk SMS Test') ->message('Send Bulk SMS Test.') ->send(); return $response->json(); } } ``` ### Queue SMS Sending (Laravel) [](#queue-sms-sending-laravel) You can also queue SMS sending. You can pass a callback function in the `queue()` method to receive the `$response` from the API call and process it further. It is really useful if you want to save the response in the database after queue executes. See example for finer detail. ``` use RahulHaque\AdnSms\Facades\AdnSms; use Illuminate\Http\Client\Response; use App\Models\Table; class SomeController { public function someFunction() { AdnSms::bulk(['01XXXXXXXXX', '02XXXXXXXXX']) ->campaignTitle('Bulk SMS Test') ->message('Send Bulk SMS Test.') ->queue(function (Response $response) { // Check if the response body is empty if ($response->body() != "") { // Store the $response in the database $model = new Table(); $model->data = $response->body(); $model->save(); } }); } } ``` Do not forget to run `php artisan queue:work`. **IMPORTANT:** `queue()` method is not available in Lumen as it does not supports queueable closer. However, you can create a queueable job in your Lumen application to do something similar. Call the `send()` method from your job and process the returned response further. ### Check Balance [](#check-balance) ``` use RahulHaque\AdnSms\Facades\AdnSms; class SomeController { /** * Make request and return response * * @return \Illuminate\Http\Client\Response * @throws \Throwable */ public function someFunction() { $response = AdnSms::checkBalance(); return $response->json(); } } ``` ### Check SMS Status [](#check-sms-status) To check already sent SMS status, simply call the `checkSmsStatus()` method with SMS UID. ``` use RahulHaque\AdnSms\Facades\AdnSms; class SomeController { /** * Make request and return response * * @return \Illuminate\Http\Client\Response * @throws \Throwable */ public function someFunction() { $response = AdnSms::checkSmsStatus('SXXXXXXXXXXXXXXXX'); return $response->json(); } } ``` ### Check Campaign Status [](#check-campaign-status) To check already sent SMS campaign status, simply call the `checkCampaignStatus()` method with campaign UID. ``` use RahulHaque\AdnSms\Facades\AdnSms; class SomeController { /** * Make request and return response * * @return \Illuminate\Http\Client\Response * @throws \Throwable */ public function someFunction() { $response = AdnSms::checkCampaignStatus('CXXXXXXXXXXXXXXXX'); return $response->json(); } } ``` ### Extras [](#extras) You can also set ADN SMS key and secret on runtime by calling the `key()` and `secret()` method which will override the settings from config file. There is a `format()` method to set message format to `TEXT|UNICODE` as well. ### Testing [](#testing) Set recipient number in `tests/Feature/AdnSmsTest.php` and run. ``` composer test ``` ### Changelog [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. ### Security [](#security) If you discover any security related issues, please email at instead of using the issue tracker. Credits ------- [](#credits) - [Rahul Haque](https://github.com/rahulhaque) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity20 Limited adoption so far Community9 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~159 days Total 4 Last Release 1438d ago PHP version history (2 changes)v1.0.0PHP ^7.1 v1.1.2PHP ^7.1|^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/f92db41064135229acef5eb1b09fb5859ea35d45a25f42745d3f3d90399483f6?d=identicon)[rahulhaque](/maintainers/rahulhaque) --- Top Contributors [![rahulhaque](https://avatars.githubusercontent.com/u/12048213?v=4)](https://github.com/rahulhaque "rahulhaque (8 commits)") --- Tags adn-smsadn-sms-laraveladn-sms-lumenadn-smsadn-sms-laraveladn-sms-lumenadnsms-laraveladnsms-lumen ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/rahulhaque-adn-sms/health.svg) ``` [![Health](https://phpackages.com/badges/rahulhaque-adn-sms/health.svg)](https://phpackages.com/packages/rahulhaque-adn-sms) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)