make($queryParams, $body); */ class WmsSign { /** @var string 应用 Secret */ private $appSecret; /** * @param string $appSecret 应用 Secret */ public function __construct($appSecret) { $this->appSecret = $appSecret; } /** * 获取 appSecret(供外部验签使用) * @return string */ public function getAppSecret() { return $this->appSecret; } // ==================== 公开方法 ==================== /** * 生成签名 * * @param array $queryParams 请求 query 参数(关联数组) * @param mixed $body 请求体(数组、对象等,传 null 表示无请求体) * @return string 签名结果(小写 MD5 字符串) */ public function make(array $queryParams, $body = null) { $canonicalQuery = $this->buildCanonicalQuery($queryParams); $bodySign = $this->buildBodySign($body); $signText = $canonicalQuery . $this->appSecret . $bodySign; return md5($signText); } // ==================== 内部方法 ==================== /** * 构建 canonicalQuery * 将 query 参数(排除 sign/signature)按 key 字母序升序排列, * 拼接为 key1=value1&key2=value2 格式。 * * @param array $queryParams * @return string */ private function buildCanonicalQuery(array $queryParams) { // 排除签名字段 $excludeKeys = ['sign', 'signature']; $filtered = []; foreach ($queryParams as $key => $value) { if (in_array($key, $excludeKeys, true)) { continue; } $filtered[$key] = $value; } // 按 key 字母序升序排列 ksort($filtered, SORT_STRING); // 拼接 $parts = []; foreach ($filtered as $key => $value) { $parts[] = $key . '=' . $this->serializeParamValue($value); } return implode('&', $parts); } /** * 序列化参数值 * 规则:undefined/null → 空字符串,对象类型 → stableStringify,其他 → String(value) * * @param mixed $value * @return string */ private function serializeParamValue($value) { if ($value === null) { return ''; } if (is_array($value) || is_object($value)) { return $this->stableStringify($value); } return (string) $value; } /** * 构建 bodySign * bodySign = md5(stableStringify(请求体)) * * @param mixed $body * @return string */ private function buildBodySign($body) { if ($body === null) { return md5(''); } return md5($this->stableStringify($body)); } // ==================== stableStringify ==================== /** * 稳定序列化:递归排序对象 key,保证相同数据始终产出相同字符串。 * * 规则: * - 对普通数组(关联数组/对象),按 key 字母序递归序列化每个字段 * - 对索引数组(list),按顺序递归序列化每个元素 * - 对非普通对象(Date 等),使用 JSON.stringify * - null 返回 "null" * * @param mixed $data * @return string */ public function stableStringify($data) { return $this->_stringify($data); } /** * 内部序列化递归 * * @param mixed $data * @return string */ private function _stringify($data) { // null if ($data === null) { return 'null'; } // 标量 if (is_bool($data)) { return $data ? 'true' : 'false'; } if (is_int($data) || is_float($data)) { // 浮点数保留足够精度,避免 1.0 和 1 产生差异 if (is_float($data)) { // 用 var_export 保留浮点精度 return var_export($data, true); } return (string) $data; } if (is_string($data)) { return $this->jsonEncodeString($data); } // 对象 if (is_object($data)) { // 非普通对象(如 DateTime 等)→ JSON.stringify if (!$this->isPlainObject($data)) { return json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); } // 普通对象 → 提取属性,按 key 排序后序列化为 {...} 格式 $props = get_object_vars($data); ksort($props, SORT_STRING); $parts = []; foreach ($props as $key => $value) { $parts[] = $this->jsonEncodeString((string) $key) . ':' . $this->_stringify($value); } return '{' . implode(',', $parts) . '}'; } // 数组 if (is_array($data)) { // 判断是否为索引数组(list) if ($this->isArrayList($data)) { $parts = []; foreach ($data as $item) { $parts[] = $this->_stringify($item); } return '[' . implode(',', $parts) . ']'; } // 关联数组 → 按 key 字母序排序 ksort($data, SORT_STRING); $parts = []; foreach ($data as $key => $value) { $parts[] = $this->jsonEncodeString((string) $key) . ':' . $this->_stringify($value); } return '{' . implode(',', $parts) . '}'; } // 兜底 return json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); } /** * JSON 编码字符串(带双引号包裹) * * @param string $str * @return string */ private function jsonEncodeString($str) { return json_encode($str, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); } /** * 判断是否为索引数组(list,即键为连续 0..n-1 的整数) * * @param array $arr * @return bool */ private function isArrayList(array $arr) { if (empty($arr)) { return true; // 空数组视为 list,输出 [] } return array_keys($arr) === range(0, count($arr) - 1); } /** * 判断是否为普通对象(stdClass 或匿名对象) * 非普通对象如 DateTime、自定义类实例等 → 用 JSON.stringify * * @param object $obj * @return bool */ private function isPlainObject($obj) { return $obj instanceof \stdClass; } }