mabehiry / sms
一个使用mobily.ws和smsgw.net API发送短信的包
dev-master
2020-11-17 06:47 UTC
Requires
- php: >=5.3.0
This package is auto-updated.
Last update: 2024-09-17 15:44:19 UTC
README
Laravel包,用于发送短信。它支持多个短信网关,并易于扩展以支持新的网关。默认配置支持mobily.ws和smsgw.net,您可以轻松添加任何其他网关(见定义新的网关)
目录
功能和需求
- 支持直接发送消息
- 支持在特定日期/时间发送消息
- 支持一次向多个号码发送消息
- 支持多种号码格式,见使用方法
- 支持同时使用多个网关和发送者名称。
- 需要任何短信网关的活跃账户。
- 支持Laravel 5.*
- cURL
- php >=5.5.0
安装
通过运行composer require mabehiry/sms:dev-master
使用composer安装
Composer将下载并安装包。如果您使用Laravel > 5.5,请直接转到配置。如果您使用laravel < 5.4,请打开config/app.php
并添加以下服务提供者和别名
'providers' => array(
...
mabehiry\sms\SmsProvider::class,
),
.
.
.
'aliases' => array(
...
'SMS' => mabehiry\sms\SMS::class,
),
配置
通过运行以下Artisan命令发布配置文件。
$ php artisan vendor:publish --provider="Mabehiry\Sms\SmsProvider"
最后,您需要编辑config/sms.php
配置文件,并填写您的网关信息。您还需要在配置文件顶部设置默认网关。
使用方法
方法
检查余额
SMS::Balance($gatewayName = false);
返回默认网关或指定网关的当前余额。
发送消息 / 消息
SMS::Send($numbers,$message,$dateTime=false,$senderName=false,$gatwayName=false);
$numbers (必需)
您可以传递单个号码或号码数组,以下为示例
- 号码可以发送带有尾随零 00966555555555
- 带有尾随加号 +966555555555
- 不带尾随零的国际号码 966555555555
- 甚至您可以使用不带国际代码的移动电话号码 - 仅限沙特阿拉伯移动电话号码 - 0555555555,该包将负责格式化号码。
$message (必需)
消息文本
$dateTime (可选)
dateTime格式 Y-m-d H:i:s
$senderName (可选)
覆盖默认发送者名称
$gatewayName (可选)
覆盖默认网关
示例
直接发送短信消息
将直接将消息发送到号码
SMS::Send(966555555555, 'Your Message Here');
如果消息发送成功,则返回true
,如果未发送,则返回false
。
向多个号码发送短信
传递号码数组而不是单个号码以发送到所有号码
$numbers = array('966555555555','966545555555','966565555555'); SMS::Send($numbers, 'Your Message Here');
如果消息发送成功,则返回true
,如果未发送,则返回false
。
在特定日期/时间发送短信消息
将在指定的日期和时间发送消息
SMS::send(966555555555, 'Your Message Here', $dateTime);
注意
- DateTime格式
Y-m-d H:i:s
- 如果消息发送成功,则返回
true
,如果未发送,则返回false
。
检查当前余额
SMS::Balance();
返回用户余额。
获取文本所需的短信消息数量
SMS::count_messages($text);
覆盖默认发送者名称
SMS::Send(966555555555, 'Your Message Here', $dateTime=false,'SenderName');
请注意,新的发送者应在mobily.ws网站上注册并激活
许可证
瓦夫公共许可证