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() 报错

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

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

③. InvalidAccessKeyId.NotFound

  • 这种提示信息,只能说明你的 accessKeyId 配置错误,注意不要配置成了 短信应用中的 AppKey
    过来人,友情提示,请看存放位置:
本作品采用《CC 协议》,转载必须注明作者和本文链接
讨论数量: 0
(= ̄ω ̄=)··· 暂无内容!

请勿发布不友善或者负能量的内容。与人为善,比聪明更重要!