PHP源码快递接口,VPS高防服务器防御速度,云主机企业网站,VPS配置云监控,vps网站大全

🗣 Wd提问: PHP源码快递接口

🤖 Ai回答:
在 PHP 中调用快递接口通常是指调用第三方快递查询 API（如：快递100、顺丰、菜鸟、快递鸟等），用于根据快递单号查询物流状态。下面我将为你提供一个完整的 PHP 源码示例，使用快递100 的公开 API 来查询快递信息。

✅ PHP 源码：调用快递100快递接口查询物流信息

🔧 前提条件：
注册快递100开发者账号：[https://www.kuaidi100.com/openapi/](https://www.kuaidi100.com/openapi/)
获取 `key`（授权密钥）
确保服务器能访问外网（支持 HTTPS）

📜 PHP 源码（完整可运行）

php
<?php
/
* PHP 调用快递100 API 查询物流信息
* 文档参考：https://www.kuaidi100.com/openapi/apiguide.shtml
*/

class ExpressQuery {
private $url = 'https://poll.kuaidi100.com/poll/query.do';
private $key; // 你的快递100授权key

public function __construct($key) {
$this-key = $key;
}

/
* 查询快递信息
* @param string $number 快递单号
* @param string $com 快递公司编码（可选，留空自动识别）
* @return array|bool
*/
public function query($number, $com = '') {
$data = [
'num' = $number,
'com' = $com,
'from' = '', // 发货地（可选）
'to' = '', // 收货地（可选）
'resultv2' = '1', // 返回详细信息
'show' = '0', // 是否显示物流详情（0=不显示，1=显示）
'muti' = '1', // 多次查询
'order' = 'desc' // 时间排序
];

// 添加签名（key + 参数拼接后MD5）
$signStr = $this-key 、json_encode($data) 、$this-key;
$sign = md5($signStr);

$data['sign'] = $sign;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $this-url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 生产环境建议开启
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/x-www-form-urlencoded'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode != 200) {
return ['status' = 'error', 'message' = 'HTTP请求失败，状态码：' 、$httpCode];
}

$result = json_decode($response, true);

if (json_last_error() !== JSON_ERROR_NONE) {
return ['status' = 'error', 'message' = '响应数据格式错误'];
}

return $result;
}
}

// ==================== 使用示例 ====================

// 替换为你在快递100申请的 key
$expressKey = 'your_kuaidi100_api_key_here'; // 👈 替换为你的 key

$express = new ExpressQuery($expressKey);

// 测试单号（示例单号，实际请使用真实单号）
$trackingNumber = '777777777777'; // 请替换为真实单号

$result = $express-query($trackingNumber);

if (isset($result['status']) && $result['status'] == '200') {
echo <h2快递信息查询结果</h2;
echo <p<strong快递公司：</strong 、htmlspecialchars($result['company']) 、</p;
echo <p<strong单号：</strong 、htmlspecialchars($result['number']) 、</p;
echo <p<strong状态：</strong 、htmlspecialchars($result['state']) 、</p;
echo <p<strong更新时间：</strong 、htmlspecialchars($result['time']) 、</p;

echo <h3物流轨迹：</h3;
if (!empty($result['data'])) {
echo <ul;
foreach ($result['data'] as $item) {
echo <li<strong 、htmlspecialchars($item['time']) 、</strong：、htmlspecialchars($item['context']) 、</li;
}
echo </ul;
} else {
echo <p暂无物流信息。</p;
}
} else {
echo <h2查询失败</h2;
echo <p错误信息：、htmlspecialchars($result['message'] ?? '未知错误') 、</p;
}

📌 注意事项：

| 项目 | 说明 |

| 快递公司编码 | 可留空让系统自动识别，如需指定，可查文档：[快递公司编码列表](https://www.kuaidi100.com/api/eindex.shtml) |
| 签名生成 | 必须使用 `key + json_encode(参数) + key` 后 MD5，否则会返回 `sign error` |
| 频率限制 | 免费版每天最多 1000 次查询，注意控制请求频率 |
| HTTPS | 必须使用 HTTPS，否则接口拒绝访问 |
| 生产环境 | 建议启用 `CURLOPT_SSL_VERIFYPEER = true` 并配置 CA 证书 |

✅ 推荐替代接口（可选）

| 接口 | 特点 |

| 快递鸟 | 支持电商系统对接，API 更规范，有 PHP SDK |
| 菜鸟裹裹开放平台 | 阿里系，适合淘宝/天猫卖家 |
| 顺丰开放平台 | 仅支持顺丰单号，但数据最准 |

如需快递鸟的 PHP SDK 示例，我也可以提供。

💡 如何获取快递100的 Key？

1、访问：https://www.kuaidi100.com/openapi/
2、注册账号 → 登录后台
3、创建应用 → 获取 `key`
4、选择“查询接口”权限

✅ 输出示例（成功时）

json
{
result: true,
message: ok,
status: 200,
com: sf,
nu: 123456789012,
condition: F00,
ischeck: 1,
com: 顺丰速运,
number: 123456789012,
state: 3, // 3=已签收，2=在途中，1=已揽收
time: 2024-06-01 10:30:20,
data: [
{
time: 2024-06-01 10:30:20,
context: 快件已签收，签收人：张三
},
{
time: 2024-05-31 18:20:10,
context: 快件已发往 [深圳市]
}
]
}

如果你需要对接快递鸟、菜鸟或顺丰的接口，或者想封装成 WordPress 插件 / Laravel 组件，也可以告诉我，我可以继续帮你扩展！

Ai作答

📣 商家广告：