需依次完成五步：一安装Overtrue/EasySms及Predis；二配置sms.php定义多网关与OrderStrategy容灾策略；三封装SmsService支持场景化发送与校验；四通过Cache标签存储验证码并严格比对；五在控制器校验参数、捕获异常并返回结构化响应。
一、安装Overtrue/EasySms依赖包
Overtrue/EasySms是一个高度抽象的PHP短信发送组件，通过统一接口屏蔽各服务商API差异，支持云片、阿里云、腾讯云等数十种网关。安装前需确认PHP版本≥7.2且已启用cURL扩展。
1、在ThinkPHP项目根目录打开终端命令行。
2、执行Composer命令安装核心包：composer require overtrue/easy-sms。
3、若需使用Redis做频次限制，同步安装Predis：composer require predis/predis。
立即学习“PHP免费学习笔记（深入）”；
二、配置多网关与策略参数
配置文件定义默认网关、备用网关列表及调用策略，是实现容灾切换与业务分流的基础。所有敏感信息必须从环境变量或独立配置文件加载，禁止硬编码。
1、在config/目录下新建sms.php文件。
2、写入标准EasySms配置结构，包含default策略与gateways明细：
3、为云片网关填入api_key；为阿里云填入access_key_id、access_key_secret、sign_name和template_code；务必确保sign_name与template_code已在对应平台审核通过。
4、设置strategy为\Overtrue\EasySms\Strategies\OrderStrategy::class以启用顺序容灾机制。
三、封装短信服务类并注入容器
将短信发送逻辑封装为可复用、可测试的服务类，便于在控制器或模型中按需调用，并支持业务类型路由（如注册、登录、支付通知）与限流校验。
1、在app/service/目录下创建SmsService.php。
2、构造函数中接收EasySms\SmsManager实例与think\Cache实例。
3、定义sendCode方法，参数含$mobile、$scene（如register）、$code；内部先校验mobile是否在白名单或未超频次限制。
4、调用$this->sms->send($mobile, [...])，模板参数键名须与平台要求一致（如阿里云用code，云片用code或number）；发送前必须对$code进行trim()和is_numeric()校验。
四、实现验证码存储与验证逻辑
验证码需安全存储于Redis或本地缓存，并绑定手机号与业务场景，防止跨场景复用或暴力穷举。过期时间与存储Key格式必须严格匹配EasySms回调与业务验证环节。
1、生成6位随机码后，使用Cache::tag('sms')->set("sms:code:{$mobile}:{$scene}", $code, 900)存入缓存。
2、Key命名规范为sms:code:{mobile}:{scene}，TTL设为900秒（15分钟）。
3、验证时调用Cache::tag('sms')->get("sms:code:{$mobile}:{$scene}")获取值，并立即delete()销毁。
4、比对前执行strval($input) === strval($cached)，禁止使用==进行弱类型比较。
五、在控制器中调用并处理异常
控制器层负责接收HTTP请求、校验参数合法性、触发服务层动作，并向客户端返回结构化响应。异常必须捕获并映射为明确业务错误码，不可透出底层SDK异常堆栈。
1、在app/controller/SmsController.php中定义send方法，接收mobile与scene参数。
2、校验手机号格式：使用正则/^1[3-9]\d{9}$/而非strlen()==11。
3、调用SmsService::sendCode($mobile, $scene)，捕获Overtrue\EasySms\Exceptions\NoGatewayAvailableException与InvalidArgumentException。
4、成功时返回['code'=>0,'msg'=>'发送成功']；失败时根据异常类型返回['code'=>4001,'msg'=>'短信通道繁忙，请稍后再试']或['code'=>4002,'msg'=>'手机号格式错误']。
