ThinkPHP5.1接入阿里云短信服务(原大鱼最新版)指导

♘背景

---

• 随着科技发展的推动，曾经充满温馨问候与回忆的短信业务，如今绝大多数局限于 验证码发送、诈骗/骚扰信息、业务推送 的使用

• 而作为一名IT搬砖的码农，对于第三方服务的接入也是必须掌握的技能，此处介绍一下 ThinkPHP5.1框架下阿里云短信最新版(原大鱼)的接入方法

• 操作环境：

	PHP版本 ：		7.0.2 (如果是低版本，报错时，可参考附录解决方案)
	ThinkPHP版本：	ThinkPHP5.1
	技能需求：		Composer 安装依赖

本文主要针对 短信 — 验证码 接入，作为指导讲解，>>> 官方文档：阿里云-短信服务

♘开发流程

---

①. 前期准备-短信使用流程

• 作为前期准备的重要指引，入驻-认证-开通服务-创建-获得参数 等在此不做赘述

详细指导参见：阿里云短信服务文档使用指引

②. Composer 安装依赖

• 作为ThinkPHP5 超方便的工具，强烈建议使用 Composer，你会发现它的便利与快捷性

运行命令： composer require alibabacloud/client

③. 快速学习(此步骤，跳过也可.)

• 阿里云提供了极其方便的在线测试功能，可以通过 快速学习，测试你是否获取了所有所需的配置信息

【短信服务】——【快速学习】——【OpenAPI Explorer】

④. 代码实现

• 注意在集成方法调用前，要先进行类的引用

use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;

• 提供集成方法如下：

   /**
     * 集成方法：阿里云(原大鱼)发送短信验证码
     * @param string $phoneNumber 目标手机号
     * TODO 注意 accessKeyId、accessSecret、signName、templateCode 重要参数的获取配置
     */
    public function sendAliDaYuAuthCode($phoneNumber = '151xxxxxxx3')
    {
        $accessKeyId = 'LTAXXXXXXXXXC';
        $accessSecret = '8gfwbXXXXXXXXXXXXXXXXXXXXXXXXXXXXA'; //注意不要有空格
        $signName = 'XXXXX'; //配置签名
        $templateCode = 'SMS_1XXXXXX5';//配置短信模板编号
        //TODO 随机生成一个6位数
        $authCodeMT = mt_rand(100000,999999);
        //TODO 短信模板变量替换JSON串,友情提示:如果JSON中需要带换行符,请参照标准的JSON协议。
        $jsonTemplateParam = json_encode(['code'=>$authCodeMT]);

        AlibabaCloud::accessKeyClient($accessKeyId, $accessSecret)
            ->regionId('cn-hangzhou')
            ->asGlobalClient();
        try {
            $result = AlibabaCloud::rpcRequest()
                ->product('Dysmsapi')
                // ->scheme('https') // https | http
                ->version('2017-05-25')
                ->action('SendSms')
                ->method('POST')
                ->options([
                    'query' => [
                        'RegionId' => 'cn-hangzhou',
                        'PhoneNumbers' => $phoneNumber,//目标手机号
                        'SignName' => $signName,
                        'TemplateCode' => $templateCode,
                        'TemplateParam' => $jsonTemplateParam,
                    ],
                ])
                ->request();
            $opRes = $result->toArray();
            //print_r($opRes);
            if ($opRes && $opRes['Code'] == "OK"){
                //进行Cookie保存
                cookie("authCodeMT",$authCodeMT,300);
            }
        } catch (ClientException $e) {
            echo $e->getErrorMessage() . PHP_EOL;
        } catch (ServerException $e) {
            echo $e->getErrorMessage() . PHP_EOL;
        }
    }

⑤. 运行效果

♘附录：

---

①. Ramsey\Uuid\Generator\random_int() 报错

• 此问题，测试发现存在于PHP版本较低的情况下，如 PHP-5.6.32，
  详细分析及解决请参考 Fatal error: Call to undefined function Ramsey\Uuid\Generator\random_int()

②. isv.INVALID_JSON_PARAM 报错的一种情况

• 如果在测试阶段，直接复制了 OpenAPI Explorer 生成的代码，有时会因为模板参数的 json 拼合无法识别
  建议，可参考我的代码思路，使用 json_encode()进行转化

③. InvalidAccessKeyId.NotFound

• 这种提示信息，只能说明你的 accessKeyId 配置错误，注意不要配置成了 短信应用中的 AppKey
  过来人，友情提示，请看存放位置：