kavo

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

先说一下吧,这篇文章主要教大家如何使用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;
    }

}



然后可以在方法中写函数调用,或者直接在控制器中调用,这里为在控制器中调用
<?php

namespace 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);
    }
}


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

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

posted on 2017-11-14 11:20  下雨天唱情歌  阅读(34)  评论(0编辑  收藏  举报  来源

导航