ybelenko/smsgorod-api-client

用于使用SmsGorod.ru提供的SMSGateway服务的库。

v2.0.0 2022-03-21 20:30 UTC

This package is auto-updated.

Last update: 2024-09-22 02:06:44 UTC


README

Latest Stable Version Build Status Coverage Status License

来自SmsGorod.ru支持服务的备注

❗ 在连接此客户端库之前,请发送电子邮件至 support@smsgorod.ru。根据您的需求,支持服务将帮助您选择相应的消息发送通道。

要求

  • 任何Web服务器,例如Apache
  • PHP ^7.0 || ^8.0
  • PHP 扩展
    • ext-curl
    • lib-curl
    • lib-libxml
    • ext-SimpleXML
    • ext-json
  • Composer
  • Shell访问权限,以便在终端中运行安装脚本

安装

安装需要 Composer。安装成功后,需要通过终端/控制台运行包的解压操作。

$ composer require ybelenko/smsgorod-api-client

使用示例

require __DIR__ . '/vendor/autoload.php';

use Ybelenko\SmsGorod\SmsGorod;
use Ybelenko\SmsGorod\Message;
use Ybelenko\SmsGorod\Abonent;

// здесь требуется подставить логин и папроль от сервиса SMSGorod
$smsGorod = new SmsGorod('логин', 'пароль');
$sender = 'VIRTA';
$messageType = Message::SMS;
$message = 'Hello World!';

// отправляем смс сообщение одному абоненту при помощи запроса к апи
$response = $smsGorod->sendMessage([
    new Message(
        $messageType,
        $message,
        [
            // телефон получателя смс
            new Abonent('79033256699'),

            // одно сообщение могут получать несколько абонентов
            // new Abonent('79033256699'),
        ],
        $sender
    ),
    // можно отправить несколько сообщений за один запрос
    // new Message(),
]);

// ответ апи в формате JSON
echo json_encode($response->sms, \JSON_PRETTY_PRINT);

运行自动测试

要运行测试,需要克隆源代码。

$ git clone https://github.com/ybelenko/smsgorod-api-client.git smsgorod-api-client-clone
$ cd smsgorod-api-client-clone
$ composer install
$ composer test

作者

© Юрий Беленко yura-bely@mail.ru 2015-2019

许可证

MIT许可证