使用工厂模式实现Thinkphp6.0接入阿里云短信-ThinkPHP-PHP中文网

使用工厂模式实现Thinkphp6.0接入阿里云短信

wpj

发布： 2020-04-29 22:39:36

原创

4437人浏览过

如今，短信验证码已成为网站、app的基础必备应用，应用场景十分丰富，随着移动互联网的发展会越来越多。作为一名码农，对第三方短信接口也是必须掌握的。本文php中文网将介绍使用工厂模式怎么实现thinkphp6.0接入阿里云短信。

一、环境要求

PHP版本 >= 7.1.0 开发环境必须安装有Composer 已开通阿里云短信服务，并且已获取AccessKey，创建模板和签名最重要的，阿里云账户余额一定要有钱。

这里我就不演示开通短信服务和创建签名模板了，小伙伴们可以查看官方文档：https://help.aliyun.com/document_detail/108072.html?spm=a2c4g.11186623.6.565.1b4825903BoqGV

二、使用Composer安装Thinkphp6.0

如果您是第一次安装，请在命令行中切换到您的web目录执行下面的命令

立即学习“PHP免费学习笔记（深入）”；

composer create-project topthink/think sms

登录后复制

本教程将安装在C盘www目录下 三、使用Composer安装 Alibaba Cloud SDK for PHP

进到刚刚创建的sms项目下执行下面的命令

composer require alibabacloud/sdk

登录后复制

四、使用编辑器打开项目，并在config文件夹下创建sms.php配置文件来管理阿里短信配置信息

<?php

return [
    //阿里云短信API接口地址
    'host'              => 'dysmsapi.aliyuncs.com',

    //AccessKey ID
    'access_key_id'     => '您的AccessKey ID',

    //Access Key Secret
    'access_key_secret' => '您的Access Key Secret',

    //地区ID
    'region_id'         => 'cn-hangzhou',

    //模板CODE
    'template_code'     => '您的模板CODE',

    //签名名称
    'sign_name'         => '您的短信签名名称',
];

登录后复制

五、顺便在config文件夹下打开cache.php添加Redis缓存配置，后面发送短信验证码会用到

<?php

// +----------------------------------------------------------------------
// | 缓存设置
// +----------------------------------------------------------------------

return [
    // 默认缓存驱动
    'default' => env('cache.driver', 'redis'),

    // 缓存连接方式配置
    'stores'  => [
        'file' => [
            // 驱动方式
            'type'       => 'File',
            // 缓存保存目录
            'path'       => '',
            // 缓存前缀
            'prefix'     => '',
            // 缓存有效期 0表示永久缓存
            'expire'     => 0,
            // 缓存标签前缀
            'tag_prefix' => 'tag:',
            // 序列化机制 例如 ['serialize', 'unserialize']
            'serialize'  => [],
        ],
        // Redis缓存
        'redis' =>  [
            //服务器地址
            'host'      =>  '127.0.0.1',
            //redis端口
            'port'      =>  6379,
            //驱动方式
            'type'      =>  'redis',
            //缓存前缀
            'prefix'    => 'sms_code_',
        ]
    ],
];

登录后复制

六、在app目录下创建common/lib/sms/Sms.php接口类，用来约束发送短信验证码的方法

<?php

namespace appcommonlibsms;

//定义实现发送短信验证码的接口类，用来约束发送验证码的方法
interface Sms
{
    /**
     * @desc 发送短信验证码的方法
     * @param string $phone 手机号
     * @param int $code     验证码
     * @return mixed
     */
    public static function sendCode(string $phone, int $code);
}

登录后复制

七、在common/lib/sms目录下创建AliSms类来实现Sms接口的smsSend()

<?php

namespace appcommonlibsms;

use AlibabaCloudClientAlibabaCloud;
use AlibabaCloudClientExceptionClientException;
use AlibabaCloudClientExceptionServerException;

class AliSms implements Sms
{

    /**
     * @desc 阿里云发送短信验证码
     * @param string $phone 手机号
     * @param int $code 验证码
     * @return mixed|void
     * @throws ClientException
     */
    public static function sendCode(string $phone, int $code)
    {
        //判断手机号和验证码是否为空
        if (empty($phone) || empty($code)){
            return false;
        }

        AlibabaCloud::accessKeyClient(config('sms.access_key_id'), config('sms.access_key_secret'))->regionId(config('sms.region_id'))->asDefaultClient();

        try {
            $result = AlibabaCloud::rpc()
                ->product('Dysmsapi')
                // ->scheme('https') // https | http
                ->version('2017-05-25')
                ->action('SendSms')
                ->method('POST')
                ->host(config('sms.host'))
                ->options([
                    'query' => [
                        'RegionId' =>config('sms.region_id'),
                        'SignName' => config('sms.sign_name'),
                        'PhoneNumbers'  =>  $phone,
                        'TemplateCode'  =>  config('sms.template_code'),
                        'TemplateParam' =>  json_encode(['code'  =>  $code]),
                    ],
                ])->request();
        } catch (ClientException $e) {
            return false;
        } catch (ServerException $e) {
            return false;
        }
        return true;
    }
}

登录后复制

八、在commonlib目录下创建生成短信验证码的类 Code.php

<?php

namespace appcommonlib;

class Code
{
    /**
     * @desc 生成4位或6位短信验证码，默认为4位
     * @param int $length 验证码长度
     * @return int
     */
    public static function getCode(int $length = 4)
    {
        $code = rand(1000,9999);
        if ($length == 6){
            $code = rand(100000,999999);
        }
        return $code;
    }
}

登录后复制

九、在common目录下创建service/Sms.php

<?php

namespace appcommonService;

use appcommonlibCode;

class Sms
{
    /**
     * @param string $phone 手机号
     * @param int $lengthCode 验证码长度
     * @param string $type 短信厂家，默认选用AliSms
     * @return mixed
     */
    public static function sendCode(string $phone,int $lengthCode,string $type='AliSms')
    {
        //生成短信验证码
        $code = Code::getCode(4);

        //使用工厂模式 调用Lib层发送短信
        $class = "appcommonlibsms\".$type;
        $sms = $class::sendCode($phone,$code);

        if ($sms){
            //发送成功,把短信验证码存储Redis缓存中，并给失效时间
            cache($phone,$code,300);
        }
        return $sms;
    }
}

登录后复制

十、在common目录下创建validate/SmsValidate验证器

<?php

namespace appcommonalidate;

use thinkValidate;

class SmsValidate extends Validate
{
    //验证规则
    protected $rule = [
        'phone'     =>  'require|mobile',
        'code'      =>  'require|number'
    ];

    //错误信息
    protected $message = [
        'phone.require'     =>  '请输入手机号',
        'phone.mobile'      =>  '手机号格式错误',
        'code.require'      =>  '短信验证码不能为空',
        'code.number'       =>  '短信验证码必须为纯数字'
    ];

    //验证场景
    protected $scene = [
        'sendCode'  =>  ['phone']
    ];
}

登录后复制

十一、在controller目录下创建Sms.php

<?php

namespace appcontroller;

use appcommonalidateSmsValidate;

class Sms
{
    /**
     * @desc 发送短信验证码
     * @return 	hink
esponseJson
     */
    public function code()
    {
        if (request()->isPost()){
            //获取手机号
            $data =  [
                'phone' =>  request()->param('phone','','trim'),
            ];

            //参数校验
            $validate = new SmsValidate();
            if (!$validate->scene('sendCode')->check($data)){
                return json(['code'=>0,'msg'=>$validate->getError()]);
            }
            //发送短信验证码
            if (ppcommonServiceSms::sendCode($data['phone'],6,'AliSms')){
                return json(['code'=>1,'msg'=>'发送成功,请注意查收。']);
            }else{
                return json(['code'=>0,'msg'=>'发送失败,请稍后重试！']);
            }

        }
    }
}

登录后复制

十二、使用PostMan测试发送短信验证码

不输入手机号或输入错误手机号会给相应的提示。

sjh格式错误.png

输入正确的手机号，提示发送短信验证成功这时我们来看看收到的验证码和缓存中的验证码是否一致到这里我们的发送验证码已经完成

十三、这时我们需要校验验证码是否正确，在appcontroller目录下创建Login.php

<?php

namespace appcontroller;

use appcommonalidateSmsValidate;

class Login
{
    public function index()
    {
        //接收参数
        $data = [
            'phone' =>  request()->param('phone','','trim'),
            'code'  =>  request()->param('code','','trim'),
        ];
        //参数校验
        $validate = new SmsValidate();
        if (!$validate->check($data)){
            return json(['code'=>0,'msg'=>$validate->getError()]);
        }

        //从Redis中获取验证码
        $redisCode = cache($data['phone']);

        //判断验证码是否正确
        if (empty($redisCode)){
            return json(['code'=>0,'msg'=>'验证码已过期,请重新发送！']);
        }
        if ($redisCode != $data['code']){
            return json(['code'=>0,'msg'=>'验证码输入错误,请重新输入！']);
        }

        return '验证成功';
    }
}

登录后复制

十四、使用PostMan校验验证码是否正确

输入错误的验证码，会给出响应的提示