阿里云短信测试控制台

发送状态查询（QuerySendDetails）

回调接收地址

一、准备阶段（阿里云控制台）

1. 开通短信服务，创建 RAM 用户并授予 AliyunDysmsFullAccess（或最小化的 dysms:SendSms、dysms:QuerySendDetails），拿到 AccessKeyId / AccessKeySecret。
2. 申请短信签名与短信模板，审核通过后分别得到「签名名称」和「模板 Code」。
3. 测试阶段需先在控制台绑定测试手机号，否则会返回 isv.SMS_TEST_NUMBER_LIMIT。

二、发送测试

1. 在「① 发送测试」填好账号与短信参数，模板参数要与模板里的变量一一对应，例如模板为「您的验证码为 ${code}」，则填 {"code":"123456"}。
2. 点「发送测试短信」，页面会展示 Code / Message / BizId / RequestId / 耗时 与原始响应。
3. 返回 Code=OK 只代表请求提交成功，真正的投递结果要看回执或状态查询。

三、两种调用方式怎么选

• HTTP 直连（默认）：按阿里云 RPC 风格 V1 签名（HMAC-SHA1）自己拼请求，不装 Composer 也能跑，真正发送失败时方便看到完整请求签名过程。
• 官方 Composer SDK：就是 阿里云短信通知示例PHP 里的调用方式。需要在示例目录执行 composer install，本工具会自动探测 vendor/autoload.php；找不到时自动降级为 HTTP 直连。

四、状态查询与回调的关系

• SendSms 返回 BizId → 用 QuerySendDetails 主动查询，或用回调被动接收。
• SendStatus：1 等待回执、2 发送失败、3 发送成功；失败时结合 ErrCode 排查。
• 状态报告回调 SmsReport 关键字段：biz_id、phone_number、success、err_code、err_msg、send_time、report_time、out_id。
• 上行短信回调 SmsUp 关键字段：phone_number、content、sign_name、send_time、dest_code。

五、常见错误码速查

六、安全提醒

• 本工具会把 AccessKeySecret 明文保存在 data/config.json，仅限本机 / 内网测试使用，不要上传到公网服务器。
• callback.php 需要对公网开放（阿里云要能访问），建议配合 IP 白名单或签名校验使用。
• 正式环境请改用 RAM 子账号 + 最小权限，并把密钥放到环境变量或配置中心，不要写死在代码里。
• Apache 已通过 data/.htaccess 禁止外部访问数据目录；若用 Nginx，请自行补一段：

  location ^~ /sms-test/data/ { deny all; }