使用 laravel sms 构建短信验证码发送校验功能
laravel 实现短信验证码功能,搜索资料发现比较流行的有两个包:
一个是laravel sms 地址
一个是easy sms 地址,
项目中需要实现一个发送和验证短信验证码的功能。以前的办法稍显繁琐。经高人指点,发现可以用 laravel-sms 这个包替代。且配置和使用简单易学。故有了这篇示例。
本例使用了laravel 5.5、 api starter kit 以及 laravel sms 2.6。
本例使用的短信服务商为。
安装
在项目根目录下执行(推荐):
composer require toplan/laravel-sms:~2.6 composer require toplan/laravel-sms:~2.6
也可以在 composer.json 的 require 字段中添加:
"toplan/laravel-sms": "2.6" "toplan/laravel-sms": "2.6"
然后在项目根目录下执行:
composer update composer update
在 config/app.php 的 providers 数组中添加:
toplan\phpsms\phpsmsserviceprovider::class, toplan\sms\smsmanagerserviceprovider::class, toplan\phpsms\phpsmsserviceprovider::class, toplan\sms\smsmanagerserviceprovider::class,
并在 aliases 数组里添加:
'phpsms' => toplan\phpsms\facades\sms::class, 'smsmanager' => toplan\sms\facades\smsmanager::class, 'phpsms' => toplan\phpsms\facades\sms::class, 'smsmanager' => toplan\sms\facades\smsmanager::class,
在项目根目录下执行:
php artisan vendor:publish --provider="toplan\phpsms\phpsmsserviceprovider" php artisan vendor:publish --provider="toplan\sms\smsmanagerserviceprovider" php artisan vendor:publish --provider="toplan\phpsms\phpsmsserviceprovider" php artisan vendor:publish --provider="toplan\sms\smsmanagerserviceprovider"
会在 config 文件夹中生成两个配置文件:phpsms.php 和 laravel-sms.php。
在 phpsms.php 中可以配置代理器信息及均衡调度方案。
在 laravel-sms.php 中可以配置验证码的发送与验证方案。
同时会向 database\migrations 中复制 2015_12_21_111514_create_sms_table.php 文件。用于生成 laravel_sms 表。
配置
这里仅以云片为例。
配置 phpsms.php
设置 phpsms.php 中 agnets 数组中云片的代理器信息。
'yunpian' => [ //用户唯一标识,必须 'apikey' => '在这里填写你的 apikey', ], 'yunpian' => [ //用户唯一标识,必须 'apikey' => '在这里填写你的 apikey', ],
设置 scheme 数组,配置均衡调度方案。
'scheme' => [ 'yunpian', ], 'scheme' => [ 'yunpian', ],
配置 laravel-sms.php
设置内置路由。
'route' => [ 'enable' => true, 'prefix' => 'laravel-sms', 'middleware' => ['api'], ], 'route' => [ 'enable' => true, 'prefix' => 'laravel-sms', 'middleware' => ['api'], ],
设置请求间隔,单位为秒。
'interval' => 60, 'interval' => 60,
设置号码验证规则。
'validation' => [ 'phone_number' => [ //需验证的字段 'ismobile' => true, //本字段是否为手机号 'enable' => true, //是否需要验证 'default' => 'mobile_required', //默认的静态规则 'staticrules' => [ //全部静态规则 'mobile_required' => 'required|zh_mobile', ], ], ], 'validation' => [ 'phone_number' => [ //需验证的字段 'ismobile' => true, //本字段是否为手机号 'enable' => true, //是否需要验证 'default' => 'mobile_required', //默认的静态规则 'staticrules' => [ //全部静态规则 'mobile_required' => 'required|zh_mobile', ], ], ],
设置验证码规则。
'code' => [ 'length' => 4, //验证码长度 'validminutes' => 10, //验证码有效时间长度,单位为分钟 'repeatifvalid' => true, //验证码有效期内是否重复使用 'maxattempts' => 0, //验证码最大尝试验证次数,0 或负数则不启用 ], 'code' => [ 'length' => 4, //验证码长度 'validminutes' => 10, //验证码有效时间长度,单位为分钟 'repeatifvalid' => true, //验证码有效期内是否重复使用 'maxattempts' => 0, //验证码最大尝试验证次数,0 或负数则不启用 ],
设置验证码内容短信。
'content' => function ($code, $minutes, $input) { return "您的验证码是:{$code} ({$minutes}分钟内有效,如非本人操作,请忽略)"; }, 'content' => function ($code, $minutes, $input) { return "您的验证码是:{$code} ({$minutes}分钟内有效,如非本人操作,请忽略)"; },
如果有需要,可以开启数据库日志。需要提前运行 php artisan migrate 生成 laravel_sms 表。
'dblogs' => 'ture', 'dblogs' => 'ture',
api 实现
在 app/utils 下新建 smscodeutil.php,并在里面实现验证码发送和校验功能。这样其他类可以随时调用,提高代码的复用性。
发送模块
发送前需要对手机号进行校验,包括:
validatesendable() :验证是否满足发送间隔 validatefields() :验证数据合法性
通过验证后,再使用 requestverifysms() 发送验证码。
具体代码如下:
use smsmanager; trait smscodeutil { public function sendsmscode() { $result = smsmanager::validatesendable(); if(!$result['success']) { return respondunprocessable($result['message']); } $result = smsmanager::validatefields(); if(!$result['success']) { return respondunprocessable($result['message']); } $result = smsmanager::requestverifysms(); if(!$result['success']) { return respondunprocessable($result['message']); } return respondsuccess($result['message']); } } use smsmanager; trait smscodeutil { public function sendsmscode() { $result = smsmanager::validatesendable(); if(!$result['success']) { return respondunprocessable($result['message']); } $result = smsmanager::validatefields(); if(!$result['success']) { return respondunprocessable($result['message']); } $result = smsmanager::requestverifysms(); if(!$result['success']) { return respondunprocessable($result['message']); } return respondsuccess($result['message']); } }
校验模块
登入时,可能需要校验手机号和验证码。所以需要在 smscodeutil.php 中添加验证码校验功能。这里官方 github 上已经给出了代码,稍作修改即可。
public function validatesmscode() { //验证数据 $validator = validator::make(inputall(), [ 'phone_number' => 'required|confirm_mobile_not_change|confirm_rule:mobile_required', 'sms_code' => 'required|verify_code', ]); if ($validator->fails()) { //验证失败后建议清空存储的发送状态,防止用户重复试错 smsmanager::forgetstate(); respondunprocessable(formatvalidationerrors($validator)); } } public function validatesmscode() { //验证数据 $validator = validator::make(inputall(), [ 'phone_number' => 'required|confirm_mobile_not_change|confirm_rule:mobile_required', 'sms_code' => 'required|verify_code', ]); if ($validator->fails()) { //验证失败后建议清空存储的发送状态,防止用户重复试错 smsmanager::forgetstate(); respondunprocessable(formatvalidationerrors($validator)); } }
功能测试
接下来配置路由和控制器,测试下功能是否正常。
可以同时打开 host-domain/laravel-sms/info
查看验证码短信发送和校验状态。
若启用了数据库日志,可以在 laravel_sms 表中查看短信发送结果的详细信息。
先在 api.php 中添加:
$api->post('/auth/send-sms-code', 'auth\logincontroller@sendsmscode'); $api->post('/auth/validate-sms-code', 'auth\logincontroller@validatesmscode'); $api->post('/auth/send-sms-code', 'auth\logincontroller@sendsmscode'); $api->post('/auth/validate-sms-code', 'auth\logincontroller@validatesmscode');
再在 logincontroller.php 中添加:
use app\utils\smscodeutil; class logincontroller extends controller { use smscodeutil; ... } use app\utils\smscodeutil; class logincontroller extends controller { use smscodeutil; ... }
然后使用 postman 或其他类似工具测试 api 功能。
发送验证码
post 服务器地址/api/auth/send-sms-code { "phone_number": "手机号" } post 服务器地址/api/auth/send-sms-code { "phone_number": "手机号" }
若通过验证并发送成功,则会返回:
{ "message": "短信验证码发送成功,请注意查收", "status_code": 200 } { "message": "短信验证码发送成功,请注意查收", "status_code": 200 }
同时填写的手机号接受到验证码。
若验证失败或发送失败,则会返回对应的错误信息。
校验验证码
post 服务器地址/api/auth/validate-sms-code { "phone_number": "手机号", "sms_code": "验证码" } post 服务器地址/api/auth/validate-sms-code { "phone_number": "手机号", "sms_code": "验证码" }
若通过验证,则无返回。
若验证失败,则会返回对应的错误信息。
本地化提示信息语言
在 laravel-sms.php 中提供了部分提示信息的自定义。想要将剩余部分的提示信息转换为本地语言,需要另行处理。
首先确保 config/app.php 中的语言设置正确。这里设置为 zh_cn。
'locale' => 'zh_cn', 'locale' => 'zh_cn',
然后在 resources\lang\zh_cn 文件夹下新建 validation.php,并填入本地化信息:
return [ 'required' => '缺少:attribute参数', 'zh_mobile' => '非标准的*手机号', 'confirm_mobile_not_change' => '提交的手机号已变更', 'verify_code' => '验证码不合法或无效', 'attributes' => [ 'phone_number' => '手机号', 'sms_code' => '验证码', ], ]; return [ 'required' => '缺少:attribute参数', 'zh_mobile' => '非标准的*手机号', 'confirm_mobile_not_change' => '提交的手机号已变更', 'verify_code' => '验证码不合法或无效', 'attributes' => [ 'phone_number' => '手机号', 'sms_code' => '验证码', ], ];
重新 post 相关地址,可以看到对应的提示信息语言已经本地化。
总结
以上所述是小编给大家介绍的使用 laravel-sms 构建短信验证码发送校验模块,希望对大家有所帮助