ThinkPHP本身不提供开箱即用的接口签名验证逻辑,所谓“支持签名”全是开发者自己封装的;必须重写verifySign方法,且服务端与客户端的参数排序、URL编码、拼接顺序、密钥使用必须完全一致,否则验签必失败。

直接说结论:ThinkPHP 本身不提供开箱即用的接口签名验证逻辑,所谓“支持签名”全是开发者自己封装的;你必须重写 verifySign 方法,且服务端与客户端的参数排序、URL 编码、拼接顺序、密钥使用必须完全一致,否则验签必失败。
为什么 http_build_query 不能直接用来拼签名串
它默认不排序,也不保证 value 的 URL 编码行为和客户端一致(比如空格、中文、+ 号处理)。ThinkPHP 的 $request->param() 更危险——它会自动合并 GET/POST/Route 参数,还可能把 "0" 转成整数 0,或把 null 变成空字符串,导致签名原文不一致。
- 必须先用
ksort()对参数数组按键名做字典序排序 - 所有 value 必须显式
urlencode()(不是rawurlencode()),且保持原始字符串形态:(string)$val强转一次 - GET 参数用
$request->get(),POST 用$request->post(),JSON Body 要用file_get_contents('php://input')拿原始字节再json_decode(..., true) - 拼接格式固定为
k1=v1&k2=v2&...&key=xxx,注意&是字面量,不是 HTML 实体
如何安全校验 timestamp 和 nonce
只比对签名正确性远远不够。攻击者截获一个合法请求,改个金额重放,只要签名没变,你就认。
-
timestamp必须是秒级 Unix 时间戳,服务端用time()对比,偏差超过 ±300 秒直接拒绝 -
nonce必须存 Redis,key 形如"nonce:{$app_id}:{$nonce}",TTL 设为 300 秒;查不到或已存在就拒掉 - 别把
sign、signature、sign_type这类字段参与签名拼接,否则循环依赖 - 所有参数值统一
trim()+ 强制 UTF-8 编码(mb_convert_encoding($v, 'UTF-8', 'auto'))
验签失败时返回什么才不算泄密
返回 "签名错误" 或 "timestamp 过期" 这类具体提示,等于告诉攻击者你哪一步校验失败了——他可以逐项试探,绕过 nonce、绕过时间窗、甚至反推你的密钥长度。
立即学习“PHP免费学习笔记(深入)”;
- 一律返回 HTTP 状态码
401+ 统一 JSON:{"code":401,"msg":"Unauthorized"} - 日志里不要记录完整原始参数,尤其
password、id_card、token必须脱敏(如"id_card":"110***1234") - 连续 5 次验签失败,按
app_id或 IP 做 Redis 计数限流,TTL 60 秒 - 开发环境可加
debug_sign=1参数临时输出签名原文,但上线前必须删掉或用env('APP_DEBUG')包裹
最常被忽略的一点:Key 长度必须 ≥32 字节。用短 key(比如 16 位字符串)调 hash_hmac('sha256', ...),SHA256 实际会被降级为弱哈希,NIST 已明确不推荐。别信“够用就行”,安全边界就卡在这儿。



















