feat: 初始化雄戈商城服务端代码与Webhook自动部署配置

这个提交包含在:
wikiboss
2026-09-12 16:40:24 +08:00
当前提交 e90ec58e61
共有 6438 个文件被更改,包括 1136083 次插入 和 0 次删除

查看文件

@@ -0,0 +1,91 @@
<?php
namespace app\admin\controller\shopro_aliyun_express;
use addons\shopro_aliyun_express\library\ExpressConfig;
use addons\shopro_aliyun_express\library\ExpressQueryService;
use app\common\controller\Backend;
use think\Db;
class Config extends Backend
{
public function index()
{
if ($this->request->isAjax()) {
$data = ExpressConfig::getInstance()->all();
$defaults = [
'express_enable' => '1',
'express_provider' => 'aliyun',
'aliyun_appcode' => '',
'aliyun_api_url' => '',
'aliyun_api_mode' => 'auto',
'aliyun_http_method' => 'auto',
'expressbird_appcode' => '',
'cache_ttl' => '300',
];
return $this->success('操作成功', null, array_merge($defaults, $data));
}
return $this->view->fetch();
}
public function save()
{
$params = $this->request->post('row/a');
if (!$params) {
$this->error('参数错误');
}
$allowed = [
'express_enable',
'express_provider',
'aliyun_appcode',
'aliyun_api_url',
'aliyun_api_mode',
'aliyun_http_method',
'expressbird_appcode',
'cache_ttl',
];
foreach ($allowed as $name) {
if (!array_key_exists($name, $params)) {
continue;
}
$exists = Db::name('shopro_aliyun_express_config')->where('name', $name)->find();
if ($exists) {
Db::name('shopro_aliyun_express_config')->where('name', $name)->update(['value' => $params[$name]]);
} else {
Db::name('shopro_aliyun_express_config')->insert(['name' => $name, 'value' => $params[$name]]);
}
}
ExpressConfig::reload();
$this->success('保存成功');
}
public function test()
{
$waybillNo = trim($this->request->post('waybill_number', ''));
$phone = trim($this->request->post('phone', ''));
$expressCode = trim($this->request->post('express_code', ''));
$provider = trim($this->request->post('express_provider', ''));
if ($waybillNo === '') {
$this->error('请填写快递单号');
}
try {
$service = new ExpressQueryService();
$normalized = $service->queryTrack($waybillNo, $phone, $expressCode, $provider ?: null, false);
if (empty($normalized['success'])) {
$raw = !empty($normalized['raw']) ? json_encode($normalized['raw'], JSON_UNESCAPED_UNICODE) : '';
$this->error('测试查询失败:未获取到有效轨迹' . ($raw ? ':' . mb_substr($raw, 0, 300) : ''));
}
$this->success('测试查询成功', null, $normalized);
} catch (\think\exception\HttpResponseException $e) {
throw $e;
} catch (\Throwable $e) {
$msg = trim($e->getMessage());
$this->error('测试查询失败:' . ($msg !== '' ? $msg : get_class($e)));
}
}
}

查看文件

@@ -0,0 +1,42 @@
<?php
namespace app\admin\controller\shopro_aliyun_express;
use addons\shopro_aliyun_express\library\Bridge;
use addons\shopro_aliyun_express\library\ExpressConfig;
use app\admin\model\shopro\order\OrderExpress;
use app\common\controller\Backend;
class Query extends Backend
{
/**
* 按包裹ID查询轨迹
*/
public function index()
{
$expressId = intval($this->request->get('express_id', 0));
if ($expressId <= 0) {
$this->error('请提供 express_id');
}
if (!ExpressConfig::getInstance()->isEnabled()) {
$this->error('快递查询插件未启用');
}
$orderExpress = OrderExpress::with('order')->where('id', $expressId)->find();
if (!$orderExpress) {
$this->error('包裹不存在');
}
$phone = $orderExpress->order ? $orderExpress->order->phone : '';
try {
$result = Bridge::queryTrack($orderExpress['express_no'], $phone, $orderExpress['express_code'], false);
$this->success('查询成功', null, $result);
} catch (\think\exception\HttpResponseException $e) {
throw $e;
} catch (\Throwable $e) {
$msg = trim($e->getMessage());
$this->error($msg !== '' ? $msg : '查询失败');
}
}
}

查看文件

@@ -0,0 +1,130 @@
<link rel="stylesheet" href="__CDN__/assets/addons/shopro/libs/element/element.css">
<style>
.express-test-result { margin-top: 16px; }
.express-test-summary { margin-bottom: 16px; }
.express-test-summary .el-descriptions { margin-top: 8px; }
.express-test-timeline { max-height: 420px; overflow-y: auto; padding-right: 8px; }
.express-test-timeline .trace-time { font-size: 13px; color: #909399; margin-bottom: 4px; }
.express-test-timeline .trace-desc { font-size: 14px; color: #303133; line-height: 1.6; }
.express-test-timeline .trace-location { font-size: 12px; color: #606266; margin-top: 4px; }
.express-test-empty { color: #909399; text-align: center; padding: 24px 0; }
</style>
<div id="aliyunExpressConfigIndex" v-cloak style="padding:20px;max-width:960px;">
<el-form label-width="180px">
<el-divider content-position="left">阿里云全国快递查询</el-divider>
<el-form-item label="功能开关">
<el-switch v-model="form.express_enable" active-value="1" inactive-value="0"></el-switch>
</el-form-item>
<el-form-item label="查询 Provider">
<el-select v-model="form.express_provider" placeholder="请选择">
<el-option label="阿里云全国快递" value="aliyun"></el-option>
<el-option label="快递鸟官方" value="kdniao"></el-option>
<el-option label="ExpressBird(阿里云市场快递鸟)" value="expressbird"></el-option>
</el-select>
</el-form-item>
<el-form-item label="轨迹缓存(秒)">
<el-input v-model="form.cache_ttl" placeholder="建议 300"></el-input>
</el-form-item>
<template v-if="form.express_provider === 'aliyun'">
<el-divider content-position="left">阿里云全国快递配置</el-divider>
<el-alert type="warning" show-icon :closable="false" style="margin-bottom:16px;"
title="接口地址必须从云市场 → 已购买服务 → 该商品 →「API 调试」复制完整 URL(含域名和路径)。"></el-alert>
<el-form-item label="APPCODE">
<el-input v-model="form.aliyun_appcode" placeholder="云市场 AppCode 页签"></el-input>
</el-form-item>
<el-form-item label="接口地址">
<el-input v-model="form.aliyun_api_url" placeholder="从 API 调试页复制完整 URL"></el-input>
</el-form-item>
<el-form-item label="接口模板">
<el-select v-model="form.aliyun_api_mode" placeholder="请选择">
<el-option label="自动(GET/POST 都试)" value="auto"></el-option>
<el-option label="快证 kzexpress (expressNo+mobile)" value="kzexpress"></el-option>
<el-option label="文档 expr POST (waybillNumber)" value="expr_post"></el-option>
<el-option label="文档 expr GET (waybillNumber)" value="expr_get"></el-option>
<el-option label="wuliu/kdi (no+type=auto)" value="wuliu_kdi"></el-option>
</el-select>
</el-form-item>
<el-form-item label="请求方式">
<el-select v-model="form.aliyun_http_method" placeholder="auto 时先 GET 再 POST">
<el-option label="自动" value="auto"></el-option>
<el-option label="GET" value="get"></el-option>
<el-option label="POST" value="post"></el-option>
</el-select>
</el-form-item>
</template>
<template v-if="form.express_provider === 'expressbird'">
<el-divider content-position="left">ExpressBird 配置</el-divider>
<el-form-item label="APPCODE">
<el-input v-model="form.expressbird_appcode" placeholder="ExpressBird APPCODE"></el-input>
</el-form-item>
</template>
<el-alert v-if="form.express_provider === 'kdniao'" type="info" show-icon :closable="false" style="margin-bottom:16px;"
title="快递鸟官方 API 请在 Shopro → 第三方服务 → 快递配置 中填写 ebusiness_id 与 appkey。"></el-alert>
<el-divider content-position="left">测试查询</el-divider>
<el-form-item label="快递单号">
<el-input v-model="testForm.waybill_number" placeholder="快递单号"></el-input>
</el-form-item>
<el-form-item label="手机号/后四位">
<el-input v-model="testForm.phone" placeholder="顺丰/中通建议填写后四位"></el-input>
</el-form-item>
<el-form-item v-if="form.express_provider === 'kdniao'" label="快递公司编码">
<el-input v-model="testForm.express_code" placeholder="快递鸟 Provider 时必填,如 SF"></el-input>
</el-form-item>
<el-form-item>
<el-button type="primary" @click="save">保存配置</el-button>
<el-button type="success" :loading="testLoading" @click="testQuery">测试查询</el-button>
</el-form-item>
<div v-if="testError" class="express-test-result">
<el-alert :title="testError" type="error" show-icon :closable="false"></el-alert>
</div>
<div v-if="testData" class="express-test-result">
<el-card shadow="never" class="express-test-summary">
<div slot="header" class="clearfix">
<span>查询结果</span>
<el-tag size="mini" type="success" style="float:right;" v-if="testData.success">查询成功</el-tag>
</div>
<el-descriptions :column="2" border size="small">
<el-descriptions-item label="快递公司">{{ testData.expressCompanyName || '-' }}</el-descriptions-item>
<el-descriptions-item label="公司编码">{{ testData.expressCompanyCode || '-' }}</el-descriptions-item>
<el-descriptions-item label="运单号">{{ testData.expressNo || testForm.waybill_number || '-' }}</el-descriptions-item>
<el-descriptions-item label="物流状态">
<el-tag size="mini" type="warning" v-if="testData.expressStatus">{{ testData.expressStatus }}</el-tag>
<span v-else>-</span>
</el-descriptions-item>
<el-descriptions-item label="最新时间" :span="2">{{ testData.lastTime || '-' }}</el-descriptions-item>
<el-descriptions-item label="最新描述" :span="2">{{ testData.lastDescription || '-' }}</el-descriptions-item>
</el-descriptions>
</el-card>
<el-card shadow="never" style="margin-bottom:12px;">
<div slot="header">物流轨迹({{ (testData.trackList || []).length }} 条)</div>
<div v-if="!(testData.trackList || []).length" class="express-test-empty">暂无轨迹节点</div>
<el-timeline v-else class="express-test-timeline">
<el-timeline-item
v-for="(item, index) in testData.trackList"
:key="index"
:timestamp="item.AcceptTime"
placement="top">
<div class="trace-desc">{{ item.AcceptStation || '—' }}</div>
<div class="trace-location" v-if="item.Location">{{ item.Location }}</div>
</el-timeline-item>
</el-timeline>
</el-card>
<el-collapse>
<el-collapse-item title="查看原始 JSON(调试)" name="raw">
<pre style="max-height:320px;overflow:auto;background:#f5f7fa;padding:12px;border-radius:4px;font-size:12px;line-height:1.5;">{{ testRawJson }}</pre>
</el-collapse-item>
</el-collapse>
</div>
</el-form>
</div>
<script src="__CDN__/assets/addons/shopro/libs/vue.js"></script>
<script src="__CDN__/assets/addons/shopro/libs/element/element.js"></script>
<script src="__CDN__/assets/js/backend/shopro_aliyun_express/config.js"></script>