- 新增 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 报错
252 lines
7.0 KiB
PHP
252 lines
7.0 KiB
PHP
<?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;
|
||
}
|
||
}
|