devineonline/smsbroadcast

用于 SMS Broadcast API 的 PHP 客户端

8.4 2021-06-16 05:55 UTC

This package is auto-updated.

Last update: 2024-09-16 12:42:23 UTC


README

SmsBroadcast PHP API 客户端

Build Status StyleCI Latest Stable Version License

这是一个简单的 SMS Broadcast API 客户端。

您可以在 此处 查看他们的 API 文档。

安装

composer require DevineOnline/sms-broadcast

用法

创建客户端

$client = \DevineOnline\SmsBroadcast\Factory\ClientFactory::create(
    'username',
    'password',
    '0412345678' // Default sender, optional
);

向单个收件人发送消息

try {
    $response = $client->send('0487654321', 'This is an sms message');
} catch (\DevineOnline\SmsBroadcast\Exception\SmsBroadcastException $e) {
    echo 'Failed to send with error: ' . $e->getMessage();
}

echo 'SMS sent, ref: ' . $response->getSmsRef();

向多个收件人发送消息

$to = ['0487654321', '0487654322', '0487654323']
$responses = $client->sendMultiple($to, 'This is an sms message');

foreach ($responses as $response) {
    echo $response->hasError()
        ? 'Failed to send SMS: ' . $response->getError()
        : 'SMS sent, ref: ' . $response->getSmsRef();
}

检查 SMS 信用余额

echo $client->getBalance(); // int(1222)

测试

默认情况下,只会运行单元测试。如果您想运行集成测试,请将 phpunit.dist.xml 文件复制到 phpunit.xml,并在文件中提供您的 SMS Broadcast 凭证以及要发送消息的电话号码。

警告 - 集成测试将发送真实短信,请确保不要在 CI 中运行它们。

composer test

待办事项

  • 支持传入消息的 Webhook