huying/sms

提供发送短信的接口

dev-master / 1.0.x-dev 2015-11-17 08:16 UTC

This package is not auto-updated.

Last update: 2024-12-07 19:12:25 UTC


README

Latest Version on Packagist Software License Build Status Coverage Status Quality Score Total Downloads

本包对常见的短信发送功能进行了抽象,包含了短信发送这一功能实现过程中需要用到的类,使得具体实现某一平台的短信发送功能异常简单。

安装

短信包开发者

通过 Composer 安装

$ composer require huying/sms

短信包使用者

直接安装对应短信平台的包即可,不需要直接安装本包,目前支持的短信平台如下:

  • 容联云通讯
  • 云片网络

使用方法

实例化短信平台类

$provider = new Huying\Sms\<ProvioderName>\Provider([
    'accountSid' => 'xxxxx',
    'authToken' => 'xxxxx',
    'appId' => 'xxxxxx',
]);

实例化时需要传给构造函数的参数在不同短信平台下一般是不一样的,具体请见相应平台的包。

直接发送短信

$message = Message::create()
    ->setRecipient('18800000000')
    ->setBody('我是短信内容')
    ->using($provider)
    ->send();

判断短信是否发送成功

if ($message->getStatus() == Huying\Sms\MessageStatus::STATUS_SENT) {
    echo '发送成功';
} else {
    echo '发送失败:错误码'.$message->getError()->getCode()
        .',错误消息:'.$message->getError()->getMessage();
}

短信池

短信池中可以放入多条短信,然后一次发送

$pool = Pool::create([$provider]);
$pool->addMessage($message1);
$pool->addMessage($message2);
$pool->send();

短信池支持设置多个平台的provider,发送短信池中短信时,会按照provider的优先级逐一尝试,直到发送成功为止

$pool = Pool::create([$provider1, $provider2]);

更新日志

请访问 更新日志 查看有关该项目的更新信息。

贡献代码

请查看 贡献指南

开发者

许可协议

本项目使用 MIT 协议,详情请查看 License File