新增

2026-08-11 17:39:41 +08:00
parent cfe4c82c90
commit 25467b9d91
350 changed files with 201115 additions and 132208 deletions
@@ -1,98 +1,98 @@
-<?php
-
-declare(strict_types=1);
-
-/**
- * 物流轨迹（顺丰 / 京东等）
- * 对接快递100「实时查询」： https://api.kuaidi100.com
- *
- * 规则：同时配置好 CUSTOMER、KEY 即自动走快递100（不必再设 ENABLE=true）。
- * 若需临时关闭（保留密钥）：LOGISTICS_KUAIDI100_DISABLE = true
- */
-$stripQuotes = static function (string $v): string {
-    $v = trim($v);
-    if (strlen($v) >= 2 && (($v[0] === '"' && $v[strlen($v) - 1] === '"') || ($v[0] === "'" && $v[strlen($v) - 1] === "'"))) {
-        return substr($v, 1, -1);
-    }
-
-    return $v;
-};
-
-// .env 为 INI 格式：写在某个 [section]（如 [trtc]）下面的键会变成 trtc.xxx，读不到顶层 LOGISTICS_*
-$envKuaidi = static function (string $suffix, $default = '') use ($stripQuotes) {
-    $top = 'LOGISTICS_KUAIDI100_' . $suffix;
-    $v = env($top, null);
-    if ($v !== null && $v !== '') {
-        return $stripQuotes((string) $v);
-    }
-    $nested = env('trtc.' . $top, $default);
-
-    return $stripQuotes((string) $nested);
-};
-
-$customer = $envKuaidi('CUSTOMER', '');
-$key = $envKuaidi('KEY', '');
-$hasCreds = $customer !== '' && $key !== '';
-$forceDisableRaw = env('LOGISTICS_KUAIDI100_DISABLE', null);
-if ($forceDisableRaw === null || $forceDisableRaw === '') {
-    $forceDisableRaw = env('trtc.LOGISTICS_KUAIDI100_DISABLE', false);
-}
-$forceDisable = filter_var($forceDisableRaw, FILTER_VALIDATE_BOOLEAN);
-// 已填 CUSTOMER+KEY 即启用；需临时关闭时设 LOGISTICS_KUAIDI100_DISABLE=true（LOGISTICS_KUAIDI100_ENABLE 已废弃，可删）
-$kuaidiEnabled = ! $forceDisable && $hasCreds;
-
-// 京东物流开放平台 LOP（https://api.jdl.com）
-// 仅当填好 APP_KEY / APP_SECRET / ACCESS_TOKEN（RSA2 模式还需 RSA_PRIVATE_KEY）时启用；
-// 作为快递100 对京东自营单（JDVE…）轨迹陈旧时的兜底数据源，并供后台「京东接口更新」按钮使用。
-// 未配置时本段 enable=false，ExpressTrackService 完全沿用现有快递100 逻辑，互不影响。
-// 加签方式由 JD_LOGISTICS_ALGORITHM 控制：rsa2（默认，需私钥） / md5（摘要，无需私钥）。
-$envJd = static function (string $suffix, $default = '') use ($stripQuotes) {
-    $top = 'JD_LOGISTICS_' . $suffix;
-    $v = env($top, null);
-    if ($v !== null && $v !== '') {
-        return $stripQuotes((string) $v);
-    }
-    // 兼容误写进 [trtc] 等分区的情况
-    $nested = env('trtc.' . $top, $default);
-
-    return $stripQuotes((string) $nested);
-};
-
-$jdAppKey = $envJd('APP_KEY', '');
-$jdAppSecret = $envJd('APP_SECRET', '');
-$jdAccessToken = $envJd('ACCESS_TOKEN', '');
-$jdHasCreds = $jdAppKey !== '' && $jdAppSecret !== '' && $jdAccessToken !== '';
-$jdDisableRaw = env('JD_LOGISTICS_DISABLE', null);
-if ($jdDisableRaw === null || $jdDisableRaw === '') {
-    $jdDisableRaw = env('trtc.JD_LOGISTICS_DISABLE', false);
-}
-$jdDisabled = filter_var($jdDisableRaw, FILTER_VALIDATE_BOOLEAN);
-$jdEnabled = ! $jdDisabled && $jdHasCreds;
-
-return [
-    'kuaidi100' => [
-        'enable' => $kuaidiEnabled,
-        'customer' => $customer,
-        'key' => $key,
-        'query_url' => $envKuaidi('QUERY_URL', 'https://poll.kuaidi100.com/poll/query.do'),
-    ],
-    'jd' => [
-        'enable' => $jdEnabled,
-        'app_key' => $jdAppKey,
-        'app_secret' => $jdAppSecret,
-        'access_token' => $jdAccessToken,
-        // LOP 网关签名算法（与官方 SDK 一致）：md5-salt（默认） / HMacMD5 / HMacSHA1 / HMacSHA256 / HMacSHA512
-        'algorithm' => $envJd('ALGORITHM', 'md5-salt'),
-        // 生产网关基址（不含路径）
-        'gateway' => $envJd('GATEWAY', 'https://api.jdl.com'),
-        // 接口 path（即签名里的 method）；京东物流标准轨迹服务（2025-04-29 改版）
-        'method' => $envJd('METHOD', '/jd/tracking/query'),
-        // LOP-DN：对接方案编码（订阅记录可查），标准轨迹服务为 Tracking_JD
-        'lop_dn' => $envJd('LOP_DN', 'Tracking_JD'),
-        // 业务体字段：单号字段名 / 单号类型（20000=运单号） / 商家编码(可选)
-        'reference_field' => $envJd('REFERENCE_FIELD', 'referenceNumber'),
-        'reference_type' => $envJd('REFERENCE_TYPE', '20000'),
-        'customer_code' => $envJd('CUSTOMER_CODE', ''),
-        'api_version' => $envJd('API_VERSION', '2.0'),
-    ],
-];
+<?php
+
+declare(strict_types=1);
+
+/**
+ * 物流轨迹（顺丰 / 京东等）
+ * 对接快递100「实时查询」： https://api.kuaidi100.com
+ *
+ * 规则：同时配置好 CUSTOMER、KEY 即自动走快递100（不必再设 ENABLE=true）。
+ * 若需临时关闭（保留密钥）：LOGISTICS_KUAIDI100_DISABLE = true
+ */
+$stripQuotes = static function (string $v): string {
+    $v = trim($v);
+    if (strlen($v) >= 2 && (($v[0] === '"' && $v[strlen($v) - 1] === '"') || ($v[0] === "'" && $v[strlen($v) - 1] === "'"))) {
+        return substr($v, 1, -1);
+    }
+
+    return $v;
+};
+
+// .env 为 INI 格式：写在某个 [section]（如 [trtc]）下面的键会变成 trtc.xxx，读不到顶层 LOGISTICS_*
+$envKuaidi = static function (string $suffix, $default = '') use ($stripQuotes) {
+    $top = 'LOGISTICS_KUAIDI100_' . $suffix;
+    $v = env($top, null);
+    if ($v !== null && $v !== '') {
+        return $stripQuotes((string) $v);
+    }
+    $nested = env('trtc.' . $top, $default);
+
+    return $stripQuotes((string) $nested);
+};
+
+$customer = $envKuaidi('CUSTOMER', '');
+$key = $envKuaidi('KEY', '');
+$hasCreds = $customer !== '' && $key !== '';
+$forceDisableRaw = env('LOGISTICS_KUAIDI100_DISABLE', null);
+if ($forceDisableRaw === null || $forceDisableRaw === '') {
+    $forceDisableRaw = env('trtc.LOGISTICS_KUAIDI100_DISABLE', false);
+}
+$forceDisable = filter_var($forceDisableRaw, FILTER_VALIDATE_BOOLEAN);
+// 已填 CUSTOMER+KEY 即启用；需临时关闭时设 LOGISTICS_KUAIDI100_DISABLE=true（LOGISTICS_KUAIDI100_ENABLE 已废弃，可删）
+$kuaidiEnabled = ! $forceDisable && $hasCreds;
+
+// 京东物流开放平台 LOP（https://api.jdl.com）
+// 仅当填好 APP_KEY / APP_SECRET / ACCESS_TOKEN（RSA2 模式还需 RSA_PRIVATE_KEY）时启用；
+// 作为快递100 对京东自营单（JDVE…）轨迹陈旧时的兜底数据源，并供后台「京东接口更新」按钮使用。
+// 未配置时本段 enable=false，ExpressTrackService 完全沿用现有快递100 逻辑，互不影响。
+// 加签方式由 JD_LOGISTICS_ALGORITHM 控制：rsa2（默认，需私钥） / md5（摘要，无需私钥）。
+$envJd = static function (string $suffix, $default = '') use ($stripQuotes) {
+    $top = 'JD_LOGISTICS_' . $suffix;
+    $v = env($top, null);
+    if ($v !== null && $v !== '') {
+        return $stripQuotes((string) $v);
+    }
+    // 兼容误写进 [trtc] 等分区的情况
+    $nested = env('trtc.' . $top, $default);
+
+    return $stripQuotes((string) $nested);
+};
+
+$jdAppKey = $envJd('APP_KEY', '');
+$jdAppSecret = $envJd('APP_SECRET', '');
+$jdAccessToken = $envJd('ACCESS_TOKEN', '');
+$jdHasCreds = $jdAppKey !== '' && $jdAppSecret !== '' && $jdAccessToken !== '';
+$jdDisableRaw = env('JD_LOGISTICS_DISABLE', null);
+if ($jdDisableRaw === null || $jdDisableRaw === '') {
+    $jdDisableRaw = env('trtc.JD_LOGISTICS_DISABLE', false);
+}
+$jdDisabled = filter_var($jdDisableRaw, FILTER_VALIDATE_BOOLEAN);
+$jdEnabled = ! $jdDisabled && $jdHasCreds;
+
+return [
+    'kuaidi100' => [
+        'enable' => $kuaidiEnabled,
+        'customer' => $customer,
+        'key' => $key,
+        'query_url' => $envKuaidi('QUERY_URL', 'https://poll.kuaidi100.com/poll/query.do'),
+    ],
+    'jd' => [
+        'enable' => $jdEnabled,
+        'app_key' => $jdAppKey,
+        'app_secret' => $jdAppSecret,
+        'access_token' => $jdAccessToken,
+        // LOP 网关签名算法（与官方 SDK 一致）：md5-salt（默认） / HMacMD5 / HMacSHA1 / HMacSHA256 / HMacSHA512
+        'algorithm' => $envJd('ALGORITHM', 'md5-salt'),
+        // 生产网关基址（不含路径）
+        'gateway' => $envJd('GATEWAY', 'https://api.jdl.com'),
+        // 接口 path（即签名里的 method）；京东物流标准轨迹服务（2025-04-29 改版）
+        'method' => $envJd('METHOD', '/jd/tracking/query'),
+        // LOP-DN：对接方案编码（订阅记录可查），标准轨迹服务为 Tracking_JD
+        'lop_dn' => $envJd('LOP_DN', 'Tracking_JD'),
+        // 业务体字段：单号字段名 / 单号类型（20000=运单号） / 商家编码(可选)
+        'reference_field' => $envJd('REFERENCE_FIELD', 'referenceNumber'),
+        'reference_type' => $envJd('REFERENCE_TYPE', '20000'),
+        'customer_code' => $envJd('CUSTOMER_CODE', ''),
+        'api_version' => $envJd('API_VERSION', '2.0'),
+    ],
+];