awd-studio / smsc

v0.4.2 2017-10-13 00:47 UTC

Requires

• php: >=5.5.9

MIT

• Anton Karpov

• api
• sms
• smsc

Published on Packagist.org on 2017-10-13 00:49 UTC

README

SMSC

Simple library for sending SMS and other messages

An API for sending short messages with the SMSC services.

Supported gateways:

• https://smsc.ua
• https://smsc.ru
• https://smsc.kz
• https://smsc.tj
• https://smscentre.com

Installing

SMSC library can be installed directly from Composer.

composer require awd-studio/smsc

How to use:

Send messages

<?php

use Smsc\Settings\Settings;
use Smsc\Services\SmscMessage;

// Create new settings item
$settings = new Settings([
    'login' => $MY_LOGIN,
    'psw'   => $MY_PASSWORD
]);

// Create new message
$options = [
    'translit' => true, // Set transliteration
];
$sms = new SmscMessage($settings, $phones, $message, $options);

// Send SMS
$sms->send();

// Get response data
$response = $smsc->getData()->getResponse();
// Or get processed results
$response = $smsc->results();

Check balance

<?php

use Smsc\Settings\Settings;
use Smsc\Services\SmscBalance;

// Create new settings item
$settings = new Settings([
    'login' => $MY_LOGIN,
    'psw'   => $MY_PASSWORD
]);

// Create new balance
$balance = new SmscBalance($settings);

// Send request
$balance->send();

Get Sender-IDs

<?php

use Smsc\Settings\Settings;
use Smsc\Services\SmscSenders;

// Create new settings item
$settings = new Settings([
    'login' => $MY_LOGIN,
    'psw'   => $MY_PASSWORD
]);

// Create new balance
$senders = new SmscSenders($settings);
$senders->getSenders();

// Send request
$senders->send();

// Manage Sender IDs
$arr = $senders->results();

More examples

<?php

use Smsc\Settings\Settings;
use Smsc\Services\SmscMessage;

// Create new settings item
$settings = new Settings([
    'login' => $MY_LOGIN,
    'psw'   => $MY_PASSWORD
]);
$sms = new SmscMessage($settings, $phones, $message, $options);

// Send MMS
$sms->mms($theme = 'My message theme');
$sms->send();

// Send E-mail
$sms->email($theme = 'My message theme');
$sms->send();

// Send Viber
$sms->viber();
$sms->send();

// Send HLR
$sms->hlr();
$sms->send();

// Send Flash-SMS
$sms->flash();
$sms->send();

// Send Ping-SMS
$sms->ping();
$sms->send();

// Voice message
$sms->call('w3'); // Voice call with women alternative voice #2.
$sms->send();

// Set additional options
$options = [
    'id'      => 123,        // Set SMS ID
    'time'    => $timestamp, // Set SMS sending time
    'valid'   => 10,         // Set SMS live time for 100 hours
    'tinyurl' => true,       // Automate short URL's
];
$sms = new SmscMessage($settings, $phones, $message, $options);
$sms->send();

More information here.