hash_hmac 是 PHP 生成 HMAC 签名的唯一推荐函数，需用原始数据与保密密钥直接计算，禁用预哈希；验签必须用 hash_equals() 防时序攻击；算法首选 sha256，参数须标准化（如 ksort + http_build_query）。
hash_hmac 是 PHP 生成 HMAC 签名的唯一推荐函数
PHP 不需要“生成 HMAC 密钥”，而是直接用 hash_hmac() 对原始数据 + 已有密钥做签名。所谓“HMAC 密钥”就是你自定义的字符串（如 $secretKey = 'my_api_secret_2026'），它不通过算法生成，也不该公开或推导——它是你和调用方共享的、保密的凭据。
常见误解是以为要像 RSA 那样“生成密钥对”，但 HMAC 是对称认证，只靠一个密钥。只要密钥足够随机、长度足够（建议 ≥32 字节）、不硬编码在前端或日志里，就满足基本安全要求。
- 密钥建议用
random_bytes(32)生成后 Base64 编码存储，避免控制字符问题 - 不要用时间戳、用户名、ID 等可预测值当密钥
- 密钥一旦泄露，整个签名体系即失效，需立即轮换
参数顺序错、数据预哈希是跨语言不一致的主因
JavaScript（CryptoJS）、Python（hmac）、Go（crypto/hmac）都要求：原始消息 + 原始密钥 → 直接进 HMAC。而很多 PHP 开发者会先 hash('sha256', $message)，再把哈希结果喂给 hash_hmac()，这会导致签名完全对不上。
正确做法永远是：原始数据原样传入，不加工、不 encode、不 trim（除非协议明确要求）。比如数组要先 ksort() + http_build_query() 统一序列化格式，但绝不能对结果再 hash 一次。
立即学习“PHP免费学习笔记（深入）”；
