README

注意： 依赖guzzlehttp/guzzle 6，安装本此包时会默认安装此依赖，可能很多其他的第三方库依赖较低版本的guzzle，如guzzle 5

此SDK主要是对 云片网络 的HTTP短信发送相关API的PHP封装。

云片网络是目前比较可靠的短信发送提供商，速度和价格都不错，由于自己项目中用到，顺便打包分享给大家。

安装

通过Composer

$ composer require ender/yunpian-sms

使用方法

如果单独使用，别忘了引入composer生成的autoload.php文件

如果是laravel用户可以不用手动include

在使用此SDK之前，别忘了先在云片网络官网注册并申请相应的apikey

示例代码如下

发送短信

use Ender\YunPianSms\SMS\YunPianSms;
$yunpianSms=new YunPianSms('xxxxxxxxxxxxxxxxxx');
$response=$yunpianSms->sendMsg('18xxxxxxx51','【云片网】您的验证码是1234');

获取当前账户余额等信息

use Ender\YunPianSms\SMS\YunPianUser;
$yunpianSms=new YunPianUser('xxxxxxxxxxxxxxxx');
$response=$yunpianSms->getAccountInfo();

构造函数参数即为你的个人的apikey

根据云片网络官方接口文档的分类，也对应的封装了三个Class

• YunPianUser
• YunPianSms
• YunPianTemplate

分别对应账户、模板、短信三部分功能，基本覆盖了所有接口。以下三个接口除外：

• 模板接口发短信（不推荐使用，新用户请用发短信） 此接口官方不推荐，所以没有封装

• 推送状态报告 这是一个推送接口，需要使用者提供url，故不作处理

• 推送回复短信 同样是个推送接口

注意： 注意部分接口是高级接口，需要申请才能使用，具体可查阅官方文档

各个接口与本SDK中方法的对应关系基本上可以从名字上猜出来，很直观，实在猜不出来进入到方法里面可以看到对应的官方http接口。

返回值说明

所有接口返回php数组格式，最外层包括http状态码和云片网络的完整返回值两部分，以短信发送接口sendMsg返回值为例，格式如下：

array (
  'status' => 200,
  'data' =>
  array (
    'code' => 0,
    'msg' => 'OK',
    'result' =>
    array (
      'count' => 1,
      'fee' => 1,
      'sid' => 1956790935,
    ),
  ),
)

data部分就是官方api的完整返回值，此处把json字符串转成了数组形式。

变更日志

请查看 CHANGELOG 以获取更多关于最近变更的信息。

测试

$ composer test

贡献

请查看 CONTRIBUTING 以获取详细信息。

安全

如果你发现任何与安全相关的问题，请通过 :author_email 发送电子邮件，而不是使用问题跟踪器。

致谢

• :author_name
• 所有贡献者

许可证

MIT许可证（MIT）。请查看 许可证文件 以获取更多信息。