♘背景

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

• 而作为一名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
  过来人，友情提示，请看存放位置：
  

本作品采用《CC 协议》，转载必须注明作者和本文链接