shengamo/zmsms

一个用于与赞比亚短信网关服务集成的 Laravel 扩展包。

0.0.4 2024-06-23 13:37 UTC

This package is auto-updated.

Last update: 2024-09-23 17:27:26 UTC


README

Latest Version on Packagist Total Downloads GitHub Actions

这里应该放你的描述。尽量限制在一到两段话,并可能提及你支持哪些PSR,以避免用户和贡献者的混淆。

安装

您可以通过 composer 安装此包

composer require shengamo/zmsms

用法

插件的过程首先是检查你是否拥有足够的余额来发送你想要发送的短信数量。如果你有足够的余额,消息将被发送,但如果你没有足够的余额,你将收到“余额不足”的响应。

配置

发布配置文件

php artisan vendor:publish --provider="Shengamo\Zmsms\ZmsmsServiceProvider"

将以下环境变量添加到你的 .env 文件中

ZMSMS_GATEWAY_BASE_URL=https://zmsms.online/api/v1/
ZMSMS_GATEWAY_USERNAME=your_user_name
ZMSMS_GATEWAY_PASSWORD=password

发送短信

如何在你的应用程序中发送短信的示例用法

use Shengamo\Zmsms\Facades\Zmsms;

Zmsms::sendSMS('senderId', 'Message', ['zambia_mobile number e.g. 0760123456']);

请确保你的发送者ID已在zmSMS上注册,否则包将返回错误。

use Shengamo\Zmsms\Facades\Zmsms;

Zmsms::sendSMS('Shengamo', 'Hello from Zmsms!', ['0971977252', '0776639088']);

检查余额

use Shengamo\Zmsms\Facades\Zmsms;

// Example usage to check SMS balance
$balance = Zmsms::getBalance();
echo "Current SMS balance: " . $balance['response_description'];

测试

vendor/bin/phpunit

变更日志

请参阅 CHANGELOG 了解最近更改的详细信息。

贡献

请参阅 CONTRIBUTING 了解详细信息。

安全性

如果你发现任何与安全性相关的问题,请通过电子邮件 mo@shengamo.com 而不是使用问题跟踪器。

致谢

许可证

MIT 许可证 (MIT)。请参阅 许可证文件 了解更多信息。