PHP Classes

File: README.md

Recommend this page to a friend!
  Classes of Zacchaeus Bolaji  >  Laravel PHP SMS API Integration  >  README.md  >  Download  
File: README.md
Role: Documentation
Content type: text/markdown
Description: Documentation
Class: Laravel PHP SMS API Integration
Abstraction to send SMS messages via multiple APIs
Author: By
Last change:
Date: 3 years ago
Size: 5,302 bytes
 

Contents

Class file image Download

Laravel SMS

CircleCI Latest Stable Version Total Downloads License StyleCI Build Status Scrutinizer Code Quality Code Coverage

Laravel SMS allows you to send SMS from your Laravel application using one of over 10 sms providers, or your own sms provider.

Installation

Step 1

You can install the package via composer:

composer require djunehor/laravel-sms

Laravel 5.5 and above

The package will automatically register itself, so you can start using it immediately.

Laravel 5.4 and older

In Laravel version 5.4 and older, you have to add the service provider in config/app.php file manually:

'providers' => [
    // ...
    Djunehor\Sms\SmsServiceProvider::class,
];

Lumen

After installing the package, you will have to register it in bootstrap/app.php file manually:

// Register Service Providers
    // ...
    $app->register(Djunehor\Sms\SmsServiceProvider::class);
];

Env Keys

SMS_SENDER=

BETASMS_USERNAME=
BETASMS_PASSWORD=

BULK_SMS_NIGERIA_TOKEN=
BULK_SMS_NIGERIA_DND=

GOLD_SMS_247_USERNAME=
GOLD_SMS_247_PASSWORD=

MULTITEXTER_USERNAME=
MULTITEXTER_PASSWORD=

SMART_SMS_TOKEN=

XWIRELESS_API_KEY=
XWIRELESS_CLIENT_ID=

NEXMO_API_KEY=
NEXMO_API_SECRET=

RING_CAPTCHA_APP_KEY=
RING_CAPTCHA_API_KEY=
RING_CAPTCHA_APP_SECRET=

AFRICASTALKING_API_KEY=
AFRICASTALKING_USERNAME=

NIGERIAN_BULK_SMS_USERNAME=
NIGERIAN_BULK_SMS_PASSWORD=

KUDI_SMS_USERNAME=
KUDI_SMS_PASSWORD=

MEBO_SMS_API_KEY=

SMSLIVE247_TOKEN=

INFOBIP_BASE_URL=
INFOBIP_USERNAME=
INFOBIP_PASSWORD=

Step 2 - Publishing files

Run: php artisan vendor:publish --tag=laravel-sms This will move the migration file, seeder file and config file to your app. You can set your sms details in the config file or via env

Step 3 - Adding SMS credentials

  • Add the env keys to your `.env` file
  • Or edit the config/laravel-sms.php file

Usage

//using betaSMS
use Djunehor\Sms\BetaSms;`

$sms = new BetaSms();
$sms->text($message)->to(08135087966)->from('MyLaravel')->send();

Using Helper function

//MeboSms
$send = send_sms($message, $to, $from, MeboSms::class);

The default SMS provider is Nexmo. You can set the default SMS provider in config/laravel-sms.php e.g 'default' => \Djunehor\Sms\Concrete\SmartSmsSolutions::class,, so you can use the helper function like this:

$send = send_sms($message, $to);
//$from is optional and is better set in the config

Available SMS Providers

|Provider|URL|Tested| |:--------- | :-----------------: | :------: | |Nexmo|https://developer.nexmo.com/api/sms#send-an-sms|Yes| |AfricasTalking|https://build.at-labs.io/docs/sms%2Fsending|Yes|| |BetaSms|https://login.betasms.com.ng/|Yes| |MultiTexter|https://web.multitexter.com/MultiTexter_HTTP_SMS_API%202.0.pdf|Yes| |BulkSmsNigeria|https://www.bulksmsnigeria.com/bulk-sms-api|Yes| |GoldSms247|https://goldsms247.com/index.php/api|Yes| |KudiSms|https://kudisms.net/api/|Yes| |Mebosms|http://mebosms.com/api-sms|Yes| |NigerianBulkSms|https://nigeriabulksms.com/sms-gateway-api/|Yes| |SmartSmsSolutions|https://docs.smartsmssolutions.com/docs/send-with-basic-route|Yes| |RingCaptcha|https://my.ringcaptcha.com/docs/api|No| |SmsLive247|http://portal.smslive247.com/developer_api/http.aspx|No| |XWireless|https://xwireless.net/cportal/knowledge-base/article/sms-3|No| |InfoBip|https://dev.infobip.com/send-sms/single-sms-message|No|

Creating custom SMS Provider

  • Create a class that extends `Djunehor\Sms\Concrete\Sms` class
  • Implement the `send()` which makes the request and return bool
  • (Optional) You can add the provider keys to the config/laravel-sms.php

Contributing

  • Fork this project
  • Clone to your repo
  • Make your changes and run tests `composer test`
  • Push and create Pull request