短信通知通知

一、插件简介

短信通知（sms）面向社区站点，对接 阿里云短信服务，支持号码认证验证码（SendSmsVerifyCode）与普通短信（SendSms）。涵盖注册/找回/绑定手机验证码、手机快捷登录、登录提醒与后台敏感操作通知。

适合需要手机号验证、快捷登录、安全告警的站点。

• 前台入口：
• 注册、找回密码、绑定手机验证码
• 登录弹窗「手机快捷登录」图标（auth_login_extra 插槽）
• 后台入口：插件列表 → 短信通知（/admin/sms）
• 主要接口（伪静态后缀下同）：
• POST /sms/sendCode — 发送验证码
• POST /sms/login — 手机验证码登录

二、核心能力

三、依赖与安装

建议环境：

• 阿里云账号，开通短信服务与（可选）号码认证服务
• 已审核通过的短信 签名
• 各场景对应的阿里云 模板 CODE
• 建议创建仅含短信权限的 RAM 子账号 AccessKey

安装步骤：

1. 应用中心安装并启用 短信通知
2. 进入 短信通知 → 短信配置，填写 AccessKey、Region、签名等
3. 在 模板管理 中配置各场景模板 CODE 与变量
4. 应用中心开启所需功能开关
5. 发送测试短信验证
6. 走通注册/登录/通知流程

数据表：

• {prefix}sms_template、{prefix}sms_log、{prefix}sms_code

场景常量： register、reset、bind、phone_login、login、operation

四、应用中心基础配置

路径：应用中心 → 短信通知 → 配置

AccessKey、签名、Endpoint 等在后台 短信配置 页维护。

五、后台重点配置

路径：插件列表 → 短信通知

5.1 短信配置（/admin/sms）

aliyunReady 条件： 启用 + AccessKey + 签名均已配置。

5.2 模板管理

默认含 phone_login（手机快捷登录）等模板；变量需与阿里云审核模板一致。

常见变量：{code}、{expire_minutes} 等。

5.3 发送记录

查看每条短信状态、错误码；支持删除与清空。

六、前台用户流程

手机快捷登录

1. 登录弹窗见手机图标（需开启「手机快捷登录」）
2. 输入手机号，获取验证码（POST /sms/sendCode，scene=phone_login）
3. 提交验证码登录（POST /sms/login）
4. 未注册且开启自动注册则创建账号

注册/找回/绑定

与邮件插件类似，通过 sendCode 接口，scene 分别为 register / reset / bind。

登录/操作通知（用户无感）

• 前台/后台登录成功 → 若用户/管理员填写了 mobile 且开关开启则发短信
• 后台敏感操作写入操作日志时触发通知

七、后台审核与运维

八、特殊说明

插件钩子：

• auth_login_extra — 登录弹窗注入手机快捷登录按钮

用户表迁移： 添加 mobile_verified 列；已有手机号默认已验证。

管理员表迁移： 添加 mobile 列供操作通知使用。

触发点（插件 README）：

• 前台登录：plugins/community/controller/Index.php::doLogin()
• 后台登录：app/controller/admin/Login.php::check()
• 后台操作：app/service/OperationLogService::write()

手机号校验： 中国大陆 11 位，normalizeMobile 去除非数字。

九、推荐上线清单

1. 阿里云签名与模板审核通过
2. 配置 RAM 子账号 AccessKey（最小权限）
3. 后台填写完整参数并测试
4. 模板 CODE 与变量名逐一核对
5. 按需开启验证码与快捷登录
6. 为管理员填写手机号（若开操作通知）
7. 测试：发码 → 登录 → 查看发送记录

十、常见问题

Q：登录弹窗没有手机图标？ 确认「手机快捷登录」开启且 aliyunReady 为真。

Q：提示模板不存在？ 后台模板 CODE 须与阿里云一致，且模板已审核通过。

Q：登录提醒没收到？ 检查用户/管理员是否填写手机号、开关是否开启；通知失败不阻断登录。

Q：号码认证 vs 普通短信？ 验证码推荐 dypns + SendSmsVerifyCode；通知类用 SendSms。

Q：自动注册关闭后？ 仅已绑定手机号的账号可通过快捷登录进入。

Q：每日上限触发？ 调整 code_daily 或等待次日；防刷设计。