Phpcms通过调用第三方物流接口实现物流功能,需集成如快递100等服务。首先注册获取customer和key,再在订单详情页添加HTML容器,使用iframe或Ajax请求接口,后端用cURL发送签名请求,前端解析返回的物流数据并展示轨迹,注意处理跨域和快递编码问题。

Phpcms 接入物流功能主要通过调用第三方物流查询接口实现,比如快递100、阿里云市场物流接口等。系统本身不自带完整的物流跟踪功能,需要手动集成。以下是具体接入和配置方法:
1. 获取物流查询接口
选择一个稳定的物流查询服务提供商:
- 快递100:免费版支持基础查询,注册后获取 customer 和 key。
- 阿里云物流查询API:需购买接口服务,返回数据规范,适合商用项目。
- 聚合数据 或 有数API:提供多种套餐,支持 JSON 返回格式。
以快递100为例,注册后获得 ID(customer)和授权Key,用于发送请求。
2. 在 Phpcms 中配置物流查询
通常在订单详情页或后台管理页面中嵌入物流信息展示。可按以下步骤操作:
立即学习“PHP免费学习笔记(深入)”;
- 打开模板文件,如 order_detail.html,在需要显示物流信息的位置添加 HTML 容器。
- 使用 JavaScript 调用快递100的实时查询接口(推荐使用跨域接口)。
示例代码(使用快递100 iframe 方式,简单稳定):
或者使用 Ajax 请求接口(需后端代理避免跨域):
- 在 Phpcms 控制器中创建一个方法,接收快递单号和公司编码。
- 通过 cURL 向快递100发送 post 请求:
$url = 'https://poll.kuaidi100.com/poll/query.do';
$post_data = array(
'customer' => '你的customer',
'param' => json_encode(array(
'com' => '快递公司编码(如:yunda)',
'num' => '快递单号',
'from' => '',
'to' => '',
'resultv2' => '1'
)),
);
$sign = strtoupper(md5($post_data['param'] . '你的key'));
$post_data['sign'] = $sign;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post_data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$result = curl_exec($ch);
curl_close($ch);
$物流信息 = json_decode($result, true);
将结果传给前端模板,用循环输出物流轨迹。
3. 前端展示物流信息
在订单详情页解析返回的物流数据,结构类似:
{
"status": "200",
"message": "ok",
"data": [
{ "time": "2024-04-01 10:00", "context": "已签收" },
{ "time": "2024-03-31 18:00", "context": "派送中" }
]
}
前端可用如下 HTML 展示:

