jandreasn/an-sms

A PHP library to send and receive SMS text messages through various providers/gateways.

AnSms - A PHP SMS library

, _(*1)

An extendable library for sending and receiving SMS messages., _(*2)

Supported SMS gateways

You can add and use your own gateway. This library enables easy switching between different gateways., _(*3)

Installation

Add the package as a requirement to your composer.json:, _(*4)

$ composer require andreasnij/an-sms

If you want to use the 46elks, Cellsynt or Telenor SMS Pro gateway you also you need implementations of PSR-7: HTTP message interfaces, PSR-17: HTTP Factories and PSR-18: HTTP Client. A popular package for this is Guzzle. You can install it with:, _(*5)

$ composer require guzzlehttp/guzzle:^7.0 guzzlehttp/psr7:^2.0

You may choose to use any other implementations of the PSR interfaces though., _(*6)

If you want to use the Twilio gateway you also need to install the Twilio SDK:, _(*7)

$ composer require twilio/sdk

If you want to use the Vonage gateway you also need to install the Vonage client:, _(*8)

$ composer require vonage/client-core

Usage

use AnSms\{
    SmsTransceiver,
    Message\Message,
    Message\PremiumMessage,
    Gateway\CellsyntGateway
};

$gateway = new CellsyntGateway('username', 'password');
$smsTransceiver = new SmsTransceiver($gateway);

// Send SMS
$message = Message::create('46700000000', 'Hello world!');
$smsTransceiver->sendMessage($message);

// Receive SMS
$receivedMessage = $smsTransceiver->receiveMessage($_GET);

// Receive SMS delivery report
$deliveryReport = $smsTransceiver->receiveDeliveryReport($_GET);

// Send Premium SMS
$premiumMessage = PremiumMessage::createFromIncomingMessage(
    'Thanks for your payment!', 
    5, 
    $receivedMessage
);
$smsTransceiver->sendMessage($premiumMessage);

Upgrading

Please see UPGRADING for details., _(*9)

Author

Andreas Nilsson (https://github.com/andreasnij), _(*10)

License

This software is licensed under the MIT license - see the LICENSE file for details., _(*11)