PHP 阿里云短信服务

╰半橙微兮° 2022-02-28 15:10 437阅读 0赞

**短信服务（Short Message Service）**

**是指通过调用短信发送API，将指定短信内容发送给指定手机用户。用户收到的短信来自106开头的号码，短信的内容多用于企业向用户传递验证码、系统通知、会员服务等信息。**

### **短信使用流程见下图：** ###

![20190326101935930.png][]

## ##

### **阿里云短信服务文档官方地址：** ###

> [https://help.aliyun.com/document\_detail/59210.html?spm=a2c4g.11174283.4.1.57132c42mjnPG9][https_help.aliyun.com_document_detail_59210.html_spm_a2c4g.11174283.4.1.57132c42mjnPG9]

### **阿里云验证码、短信通知类：** ###

<?php
    /**
     * 阿里云短信验证码、短信通知发送类
     * @author Administrator
     *
     */
    class Sms {
        // 保存错误信息
        public $error;
        // Access Key ID
        private $accessKeyId = '';
        // Access Access Key Secret
        private $accessKeySecret = '';
        // 签名
        private $signName = '';
        // 模版ID
        private $templateCode = '';
        public function __construct($cofig = array()) {
            /*
             * 通过参数传递
             * $cofig = array (
                'accessKeyId' => 'xxxxxxxxxxxx',
                'accessKeySecret' => 'xxxxxxxxxxxxxxxx',
                'signName' => 'xxxxxxxxxx',
                'templateCode' => 'xxxxxxxxxxx'
            );*/
            // 配置参数
            $this->accessKeyId = $cofig ['accessKeyId'];
            $this->accessKeySecret = $cofig ['accessKeySecret'];
            $this->signName = $cofig ['signName'];
            $this->templateCode = $cofig ['templateCode'];
        }
        private function percentEncode($string) {
            $string = urlencode ( $string );
            $string = preg_replace ( '/\+/', '%20', $string );
            $string = preg_replace ( '/\*/', '%2A', $string );
            $string = preg_replace ( '/%7E/', '~', $string );
            return $string;
        }
        /**
         * 签名
         *
         * @param unknown $parameters
         * @param unknown $accessKeySecret
         * @return string
         */
        private function computeSignature($parameters, $accessKeySecret) {
            ksort ( $parameters );
            $canonicalizedQueryString = '';
            foreach ( $parameters as $key => $value ) {
                $canonicalizedQueryString .= '&' . $this->percentEncode ( $key ) . '=' . $this->percentEncode ( $value );
            }
            $stringToSign = 'GET&%2F&' . $this->percentencode ( substr ( $canonicalizedQueryString, 1 ) );
            $signature = base64_encode ( hash_hmac ( 'sha1', $stringToSign, $accessKeySecret . '&', true ) );
            return $signature;
        }
        /**
         * @param unknown $mobile
         * @param unknown $verify_code
         *
         */
        public function send_verify($mobile, $verify_code) {
            $params = array (
                'SignName' => $this->signName,
                'Format' => 'JSON',
                'Version' => '2017-05-25',
                'AccessKeyId' => $this->accessKeyId,
                'SignatureVersion' => '1.0',
                'SignatureMethod' => 'HMAC-SHA1',
                'SignatureNonce' => uniqid (),
                'Timestamp' => gmdate ( 'Y-m-d\TH:i:s\Z' ),
                'Action' => 'SendSms',
                'TemplateCode' => $this->templateCode,
                'PhoneNumbers' => $mobile,
                'TemplateParam' => '{"code":"' . $verify_code . '"}'// 更换为自己的实际模版
            );
            // 计算签名并把签名结果加入请求参数
            $params ['Signature'] = $this->computeSignature ( $params, $this->accessKeySecret );
            // 发送请求（此处作了修改）
            //$url = 'https://sms.aliyuncs.com/?' . http_build_query ( $params );
            $url = 'http://dysmsapi.aliyuncs.com/?' . http_build_query ( $params );
            $ch = curl_init ();
            curl_setopt ( $ch, CURLOPT_URL, $url );
            curl_setopt ( $ch, CURLOPT_SSL_VERIFYPEER, FALSE );
            curl_setopt ( $ch, CURLOPT_SSL_VERIFYHOST, FALSE );
            curl_setopt ( $ch, CURLOPT_RETURNTRANSFER, 1 );
            curl_setopt ( $ch, CURLOPT_TIMEOUT, 10 );
            $result = curl_exec ( $ch );
            curl_close ( $ch );
            $result = json_decode ( $result, true );
            if (  $result ['Code'] != 'OK') {
                $this->error = $this->getErrorMessage ( $result ['Code'] );
                return false;
            }
            return true;
        }
        /**
         * 获取详细错误信息
         *
         * @param unknown $status
         */
        public function getErrorMessage($status) {
            // 阿里云的短信 乱八七糟的(其实是用的阿里大于)
            // https://api.alidayu.com/doc2/apiDetail?spm=a3142.7629140.1.19.SmdYoA&apiId=25450
            $message = array (
                'isv.BUSINESS_LIMIT_CONTROL' => '短信发送频率超限',
                'isv.DAY_LIMIT_CONTROL' => '已经达到您在控制台设置的短信日发送量限额值',
                'isv.SMS_CONTENT_ILLEGAL' => '短信内容包含禁止发送内容,请修改短信文案',
                'isv.SMS_SIGN_ILLEGAL' => '签名禁止使用,请在短信服务控制台中申请符合规定的签名',
                'isp.RAM_PERMISSION_DENY' => 'RAM权限不足。,请为当前使用的AK对应子账号进行授权：AliyunDysmsFullAccess（管理权限）',
                'isv.OUT_OF_SERVICE' => '余额不足。余额不足时，套餐包中即使有短信额度也无法发送短信',
                'isv.PRODUCT_UN_SUBSCRIPT' => '未开通云通信产品的阿里云客户',
                'isv.PRODUCT_UNSUBSCRIBE' => '产品未开通',
                'isv.ACCOUNT_NOT_EXISTS' => '账户不存在，使用了错误的账户名称或AK',
                'isv.ACCOUNT_ABNORMAL' => '账户异常',
                'isv.SMS_TEMPLATE_ILLEGAL' => '短信模板不存在，或未经审核通过',
                'isv.SMS_SIGNATURE_ILLEGAL' => '签名不存在，或未经审核通过',
                'isv.INVALID_PARAMETERS' => '参数格式不正确',
                'isv.MOBILE_NUMBER_ILLEGAL' => '机号码格式错误',
                'isv.MOBILE_COUNT_OVER_LIMIT' => '参数PhoneNumbers中指定的手机号码数量超出限制',
                'isv.TEMPLATE_MISSING_PARAMETERS' => '模版缺少变量',
                'isv.BLACK_KEY_CONTROL_LIMIT' => '黑名单管控',
                'isv.PARAM_LENGTH_LIMIT' => '参数超出长度限制',
                'isv.PARAM_NOT_SUPPORT_URL' => '不支持URL',
                'isv.AMOUNT_NOT_ENOUGH' => '账户余额不足',
                'SignatureDoesNotMatch' => '签名（Signature）加密错误',
            );
            if (isset ( $message [$status] )) {
                return $message [$status];
            }
            return $status;
        }
    }

## ##

### **调用：** ###

// 发送验证码（阿里云）
    public function smsCode() {
        require '../extend/aly/Sms.php';  // 路径需要修改为你项目的存放文件的路径
        $tel = input('tel');   // 接收前端传来的手机号
        $config = [
            'accessKeyId' => '',                // 填上你的 accessKeyId
            'accessKeySecret' => '',            // 填上你的 accessKeySecret
            'signName' => '阿里云短信测试专用',   // 签名名称
            'templateCode' => ''                // 模板code值
        ];
    
        $code = rand(1000, 9999);    //随机生成短信验证码
        $sms = new \Sms($config);
        $status = $sms->send_verify($tel, $code);   //发送短信
        if (!$status) {
            echo $sms->error;
        } else {
            echo '短信发送成功！ 验证码为：' .$code;
        }
    }
    
    
    // 发送短信通知（阿里云）
    public function smsMessage() {
        require '../extend/aly/Sms.php';
        $tel = input('tel');    // 手机号
        $name = input('name');  // 姓名
        $config = [
            'accessKeyId' => '',
            'accessKeySecret' => '',
            'signName' => '阿里云短信测试专用',   // 签名名称
            'templateCode' => ''                // 模板code值
        ];
    
        $sms = new \Sms($config);
        $status = $sms->send_verify($tel, $name);   //发送短信
        if (!$status) {
            echo $sms->error;
        } else {
            echo '短信通知发送成功！';
        }
    }

需要注意的是Sms类文件里的send\_verify方法，

把数组中的 'TemplateParam' 字段值，更换为你实际的模板内容中的变量。

**如果是发送短信验证码，比如你的模板内容是以下这样的话：**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzIzMzc1NzMz_size_16_color_FFFFFF_t_70][]

> 'TemplateParam' => '\{"code":"' . $verify\_code . '"\}'

**如果是发送短信通知，比如你的模板内容是以下这样的话：**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzIzMzc1NzMz_size_16_color_FFFFFF_t_70 1][]

那么你的 'TemplateParam' 值应该是这样：

>  'TemplateParam' => '\{"name":"' . $verify\_code . '"\}'

具体可根据实际需求修改！

[20190326101935930.png]: /images/20220228/3f59a086c7e44a4eb406aa2d803bf1a5.png
[https_help.aliyun.com_document_detail_59210.html_spm_a2c4g.11174283.4.1.57132c42mjnPG9]: https://help.aliyun.com/document_detail/59210.html?spm=a2c4g.11174283.4.1.57132c42mjnPG9
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzIzMzc1NzMz_size_16_color_FFFFFF_t_70]: /images/20220228/9735e484882f433c9743caca2df0c53d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzIzMzc1NzMz_size_16_color_FFFFFF_t_70 1]: /images/20220228/db5ec4dfacec4a6e88cabea05a0721d7.png