liufumingren 94fd06c6ab 1
2026-08-07 00:22:37 +08:00

155 lines
4.7 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\func;
use app\index\library\new_wms\WmsSign;
use fast\Http;
/**
* WMS 开放接口 — 方法调用基类
*
* 封装签名、HTTP 请求、响应解析等公共逻辑。
* 各业务模块(Index / Store / Inbox)继承此类,只需声明 method 并传入业务参数即可。
*
* 约定:
* - 所有接口统一 POST 到 {baseUrl}/warehouse
* - 签名参数通过 query string 传递
* - 请求体为 JSON
* - 配置从 application/extra/wms.php 自动读取
*
* 使用示例:
* $index = new Index();
* $result = $index->ping();
*/
abstract class Base
{
/** @var WmsSign */
protected $signer;
/** @var string */
protected $appKey;
/** @var string */
protected $baseUrl;
/** @var string */
protected $version;
/** @var int */
protected $timeout;
/** @var int */
protected $connectTimeout = 5;
public function __construct()
{
$wms = config('wms') ?: [];
$this->appKey = $wms['app_key'] ?? '';
$this->signer = new WmsSign($wms['app_secret'] ?? '');
$this->baseUrl = rtrim($wms['base_url'] ?? '', '/');
$this->version = $wms['version'] ?? '1.0';
$this->timeout = (int) ($wms['timeout'] ?? 10);
}
// ==================== 子类需覆盖 ====================
/**
* 返回当前模块名(如 'index'、'store'、'inbox')
* @return string
*/
abstract protected function moduleName();
// ==================== 公共调用方法 ====================
/**
* 调用 WMS 开放接口
*
* @param string $methodName 方法名(如 'ping'、'list'、'push')
* @param array $body 请求体(关联数组),空 body 传 []
* @param array $extraQuery 额外的 query 参数
* @return array 解析后的响应数组,包含 code / msg / data
*/
protected function call($methodName, array $body = [], array $extraQuery = [])
{
$method = $this->moduleName() . '.' . $methodName;
$body = !empty($body) ? $body : new \stdClass(); // 空 body → {}
// ---- 构建 query 参数 ----
$timestamp = time();
$nonce = $this->generateNonce(16);
$queryParams = array_merge([
'app_key' => $this->appKey,
'method' => $method,
'timestamp' => $timestamp,
'v' => $this->version,
'nonce' => $nonce,
], $extraQuery);
// ---- 签名 ----
$sign = $this->signer->make($queryParams, $body);
// ---- 发起请求 ----
$queryStr = http_build_query(array_merge($queryParams, ['sign' => $sign]));
$url = $this->baseUrl . '/warehouse?' . $queryStr;
$bodyJson = json_encode($body, JSON_UNESCAPED_UNICODE);
\think\Log::info("[WmsFunc] {$method} 请求: " . json_encode([
'url' => $url,
'query' => $queryParams,
'body' => $bodyJson,
'sign' => $sign,
], JSON_UNESCAPED_UNICODE));
try {
$response = Http::post($url, $bodyJson, [
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
],
CURLOPT_TIMEOUT => $this->timeout,
CURLOPT_CONNECTTIMEOUT => $this->connectTimeout,
]);
$result = json_decode($response, true);
if ($result === null && json_last_error() !== JSON_ERROR_NONE) {
\think\Log::error("[WmsFunc] {$method} 响应解析失败\nURL: {$url}\nBody: {$bodyJson}\nResponse: {$response}");
return [
'code' => -1,
'msg' => '响应解析失败',
'data' => null,
];
}
\think\Log::info("[WmsFunc] {$method} 响应: " . json_encode($result, JSON_UNESCAPED_UNICODE));
return $result;
} catch (\Exception $e) {
\think\Log::error("[WmsFunc] {$method} 请求异常: " . $e->getMessage() . "\nURL: {$url}\nBody: {$bodyJson}");
return [
'code' => -1,
'msg' => '请求异常: ' . $e->getMessage(),
'data' => null,
];
}
}
// ==================== 工具方法 ====================
/**
* 生成随机 nonce
* @param int $length
* @return string
*/
protected function generateNonce($length = 16)
{
$chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
$nonce = '';
for ($i = 0; $i < $length; $i++) {
$nonce .= $chars[random_int(0, strlen($chars) - 1)];
}
return $nonce;
}
}