thinkphp5详细使用阿里云短信最新版(原大鱼)教程!

来源:互联网 发布:拼布行业发展经济数据 编辑:程序博客网 时间:2024/05/01 18:56
先说一下吧,这篇文章主要教大家如何使用tp5来使用阿里短信平台最新版2.0sdk,也就是所谓的前阿里大鱼。
但是高手略过啊,只针对新手,如果大家发现有什么问题,欢迎留言指出,我会更正!

首先我们下载官方完整包的SDK:[url]https://help.aliyun.com/document_detail/55359.html?spm=5176.doc55451.6.580.3rgXTq[/url]
官方标明了啊,PHP版本一定要不低于5.5
下载后目录如下:
SDK工具包目录结构如下:    \_api_demo    |   \_SmsDemo.php        短信服务相关接口demo示例    \_api_sdk    |   \_lib    |   |   \_Api            包含Api接口请求体的封装    |   |   \_Core            包含签名生成、Region配置等封装    |   \_test                单元测试    |   \_vendor            composer依赖打包    \_msg_demo    |   \_lib                示例依赖项    |   \_MsgDemo.php        短信服务状态报告demo示例    \_msg_sdk      \_lib      |   \_Api                包含Api接口请求体的封装      |   \_Core            包含签名生成、Region配置等等封装      |   \_MNS                包含消息服务相关封装      \_test                单元测试      \_vendor                composer依赖打包


官方封装的很多文件其实我们是用不上的,[b]我们只需要将目录里的api_sdk复制出来到tp5根目录的extend下面。[/b]
文件夹复制过去后,我们最好更改一下名称,比如我们更改为alisms。

接下来介绍两种方法使用。

第一种:直接在应用目录下的函数库common里写函数调用
首先在函数顶部引入阿里云短信的命名空间,无需修改,官方sdk自带的命名空间use Aliyun\Core\Config;use Aliyun\Core\Profile\DefaultProfile;use Aliyun\Core\DefaultAcsClient;use Aliyun\Api\Sms\Request\V20170525\SendSmsRequest;//阿里短信函数,$mobile为手机号码,$code为自定义随机数function sendMsg($mobile,$code){    //这里的路径EXTEND_PATH就是指tp5根目录下的extend目录,系统自带常量。alisms为我们复制api_sdk过来后更改的目录名称    require_once EXTEND_PATH.'alisms/vendor/autoload.php';    Config::load();             //加载区域结点配置    $accessKeyId = '×××××××××××××';  //阿里云短信获取的accessKeyId    $accessKeySecret = '×××××××××××××';    //阿里云短信获取的accessKeySecret    //这个个是审核过的模板内容中的变量赋值,记住数组中字符串code要和模板内容中的保持一致    //比如我们模板中的内容为:你的验证码为:${code},该验证码5分钟内有效,请勿泄漏!    $templateParam = array("code"=>$code);           //模板变量替换    $signName = '浪博电子'; //这个是短信签名,要审核通过    $templateCode = 'SMS_×××××××';   //短信模板ID,记得要审核通过的    //短信API产品名(短信产品名固定,无需修改)    $product = "Dysmsapi";    //短信API产品域名(接口地址固定,无需修改)    $domain = "dysmsapi.aliyuncs.com";    //暂时不支持多Region(目前仅支持cn-hangzhou请勿修改)    $region = "cn-hangzhou";    // 初始化用户Profile实例    $profile = DefaultProfile::getProfile($region, $accessKeyId, $accessKeySecret);    // 增加服务结点    DefaultProfile::addEndpoint("cn-hangzhou", "cn-hangzhou", $product, $domain);    // 初始化AcsClient用于发起请求    $acsClient= new DefaultAcsClient($profile);    // 初始化SendSmsRequest实例用于设置发送短信的参数    $request = new SendSmsRequest();    // 必填,设置雉短信接收号码    $request->setPhoneNumbers($mobile);    // 必填,设置签名名称    $request->setSignName($signName);    // 必填,设置模板CODE    $request->setTemplateCode($templateCode);    // 可选,设置模板参数    if($templateParam) {        $request->setTemplateParam(json_encode($templateParam));    }    //发起访问请求    $acsResponse = $acsClient->getAcsResponse($request);    //返回请求结果    $result = json_decode(json_encode($acsResponse),true);    return $result;}



然后我们在控制器中方法直接调用,代码如下:
 /*         * 前台ajax请求发送短信验证码         */        public function sendSms($phone)        {            $mobile = $phone;            //$code = 1111;            $code = mt_rand(10000, 99999);            $result = sendMsg($mobile, $code);            //$result['Code'] = 'OK';            if ($result['Code'] == 'OK') {                //存到缓存当中,并且返回json数据给前端                cache('tel' . $mobile, $code, 39);                return json(['success' => 'ok', 'tel' => $mobile]);            }        }[/code]如果发送成功,将返回以下内容,当然你也可以自定义输出$sms为数组格式或者json格式[code]array(4) {  ["Message"] => string(2) "OK"  ["RequestId"] => string(36) "5340C2E9-6802-4EA6-90E3-392518495E6A"  ["BizId"] => string(20) "519300710627122289^0"  ["Code"] => string(2) "OK"}



第二种方法:我们直接在extend下面的alisms目录下写一个类
<?php/** * Created by pan. * User: pan * Date: 2017/11/14 * Time: 9:41 *///[b]命名空间为alisms[/b]namespace alisms;//引入sdk的命名空间use Aliyun\Core\Config;use Aliyun\Core\Profile\DefaultProfile;use Aliyun\Core\DefaultAcsClient;use Aliyun\Api\Sms\Request\V20170525\SendSmsRequest;//引入autoload.php,EXTEND_PATH就是指tp5根目录下的extend目录,系统自带常量。alisms为我们复制api_sdk过来后更改的目录名称require_once EXTEND_PATH.'alisms/vendor/autoload.php';Config::load();             //加载区域结点配置class SendSms{    //关键的配置,我们用成员属性    public $accessKeyId = null; //阿里云短信获取的accessKeyId    public $accessKeySecret = null; //阿里云短信获取的accessKeySecret    public $signName = null;    //短信签名,要审核通过    public $templateCode = null;    //短信模板ID,记得要审核通过的    public function send($mobile,$templateParam)    {        //获取成员属性        $accessKeyId     = $this->accessKeyId;        $accessKeySecret = $this->accessKeySecret;        $signName        = $this->signName;        $templateCode    = $this->templateCode;        //短信API产品名(短信产品名固定,无需修改)        $product = "Dysmsapi";        //短信API产品域名(接口地址固定,无需修改)        $domain = "dysmsapi.aliyuncs.com";        //暂时不支持多Region(目前仅支持cn-hangzhou请勿修改)        $region = "cn-hangzhou";        // 初始化用户Profile实例        $profile = DefaultProfile::getProfile($region, $accessKeyId, $accessKeySecret);        // 增加服务结点        DefaultProfile::addEndpoint("cn-hangzhou", "cn-hangzhou", $product, $domain);        // 初始化AcsClient用于发起请求        $acsClient= new DefaultAcsClient($profile);        // 初始化SendSmsRequest实例用于设置发送短信的参数        $request = new SendSmsRequest();        // 必填,设置雉短信接收号码        $request->setPhoneNumbers($mobile);        // 必填,设置签名名称        $request->setSignName($signName);        // 必填,设置模板CODE        $request->setTemplateCode($templateCode);        // 可选,设置模板参数        if($templateParam) {            $request->setTemplateParam(json_encode($templateParam));        }        //发起访问请求        $acsResponse = $acsClient->getAcsResponse($request);        //返回请求结果,这里为为数组格式        $result = json_decode(json_encode($acsResponse),true);        return $result;    }}



然后可以在方法中写函数调用,或者直接在控制器中调用,这里为在控制器中调用
<?phpnamespace app\index\controller;use think\Request;//[b]记得引入命名空间,如果这里不引入命名空间,那么方法中的实例化SendSms的格式应该为:$sms = new \alisms\SendSms()[/b]use alisms\SendSms;class Index extends Base{    public function index()    {         //获取对象,如果上面没有引入命名空间,可以这样实例化:$sms = new \alisms\SendSms()        $sms = new SendSms();        //设置关键的四个配置参数,其实配置参数应该写在公共或者模块下的config配置文件中,然后在获取使用,这里我就直接使用了。        $sms->accessKeyId = '××××××××';        $sms->accessKeySecret = '×××××××××';        $sms->signName = '浪博电子';        $sms->templateCode = 'SMS_×××××××';                //$mobile为手机号        $mobile = '×××××××';        //模板参数,自定义了随机数,你可以在这里保存在缓存或者cookie等设置有效期以便逻辑发送后用户使用后的逻辑处理        $code = mt_rand();        $templateParam = array("code"=>$code);        $m = $sms->send($mobile,$templateParam);        //类中有说明,默认返回的数组格式,如果需要json,在自行修改类,或者在这里将$m转换后在输出        dump($m);    }}


至此结束,至于发送后使用的业务逻辑,就要结合你自己实际的业务场景了。

花了两个多小时边琢磨,边写下来分享给大家,还请大家点赞支持!
原创粉丝点击