phpcms物流怎么接？物流查询如何配置显示？-PHPCMS-PHP中文网

phpcms物流怎么接？物流查询如何配置显示？

星降

发布： 2025-11-12 22:20:03

原创

195人浏览过

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

phpcms物流怎么接？物流查询如何配置显示？

Phpcms 接入物流功能主要通过调用第三方物流查询接口实现，比如快递100、阿里云市场物流接口等。系统本身不自带完整的物流跟踪功能，需要手动集成。以下是具体接入和配置方法：

1. 获取物流查询接口

选择一个稳定的物流查询服务提供商：

快递100：免费版支持基础查询，注册后获取 customer 和 key。
阿里云物流查询API：需购买接口服务，返回数据规范，适合商用项目。
聚合数据 或 有数API：提供多种套餐，支持 JSON 返回格式。

以快递100为例，注册后获得 ID（customer）和授权Key，用于发送请求。

2. 在 Phpcms 中配置物流查询

通常在订单详情页或后台管理页面中嵌入物流信息展示。可按以下步骤操作：

立即学习“PHP免费学习笔记（深入）”；

打开模板文件，如 order_detail.html，在需要显示物流信息的位置添加 HTML 容器。
使用 JavaScript 调用快递100的实时查询接口（推荐使用跨域接口）。

示例代码（使用快递100 iframe 方式，简单稳定）：

<iframe src="https://m.kuaidi100.com/index_all.html?type=自动识别快递公司&postid=你的单号" width="100%" height="400" frameborder="0"></iframe>

登录后复制

或者使用 Ajax 请求接口（需后端代理避免跨域）：

在 Phpcms 控制器中创建一个方法，接收快递单号和公司编码。
通过 cURL 向快递100发送 post 请求：

造好物

一站式AI造物设计平台

查看详情

$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;
<p>$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);</p>

登录后复制

将结果传给前端模板，用循环输出物流轨迹。

3. 前端展示物流信息

在订单详情页解析返回的物流数据，结构类似：

{
  "status": "200",
  "message": "ok",
  "data": [
    { "time": "2024-04-01 10:00", "context": "已签收" },
    { "time": "2024-03-31 18:00", "context": "派送中" }
  ]
}

登录后复制

前端可用如下 HTML 展示：

<div class="logistics-trace">
  <h4>物流跟踪</h4>
  <ul>
    <!-- loop $logistics['data'] as $item --&gt
    <li><span>{$item['time']}</span> {$item['context']}</li>
    <!-- /loop --&gt
  </ul>
</div>

登录后复制