liufumingren c35ac184ae feat: WMS 开放接口签名 & 消息转发模块
- 新增 extra/wms.php 统一配置(app_key/app_secret/base_url)
- 新增 WmsSign.php 签名工具(canonicalQuery + bodySign + stableStringify)
- 新增 WmsVerify.php 验签工具(恒定时间比较防时序攻击)
- 新增 func/ 目录与远端 API 对应(Index.ping / Store.list / Inbox.push)
- 重构 Forward.php 使用 Inbox.push 转发群聊消息到 WMS 站内信
- Chat.php processMessage 接入 Forward 转发,异常不阻塞原有流程
- 删除冗余 WmsSignConfig.php,配置统一从 config('wms') 读取
- 修复 deploy.js chown/chmod .user.ini 报错
2026-08-06 22:46:30 +08:00

252 lines
7.0 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
namespace app\index\library\new_wms;
/**
* WMS 开放接口签名工具
*
* 签名算法:
* canonicalQuery = 将 query 参数(排除 sign/signature)按 key 字母序升序排列,
* 拼接为 key1=value1&key2=value2 格式。
* 参数值序列化规则:undefined/null → 空字符串,
* 对象类型 → stableStringify 序列化,其他 → String(value)。
* bodySign = md5(stableStringify(请求体))
* signText = canonicalQuery + self_app_secret + bodySign
* sign = md5(signText).toLowerCase()
*
* 配置来源:application/extra/wms.php
*
* 使用示例:
* $signer = new WmsSign('abc123');
* $sign = $signer->make($queryParams, $body);
*/
class WmsSign
{
/** @var string 应用 Secret */
private $appSecret;
/**
* @param string $appSecret 应用 Secret
*/
public function __construct($appSecret)
{
$this->appSecret = $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);
}
// 普通对象 → 提取属性,按 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 编码字符串(带双引号包裹)
*
* @param string $str
* @return string
*/
private function jsonEncodeString($str)
{
return json_encode($str, JSON_UNESCAPED_UNICODE);
}
/**
* 判断是否为索引数组(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;
}
}