PHP 快递单号查询api接口源码指导
快递查询源码
背景
- 最近进行网站后台开发，需要实现物流的即时查询，发现之前集成的
快递100物流查询 API——【PHP 快递查询源码资源】 已经不能正常使用了； 为了方便以后的业务需求，经过比较，最后选择使用 第三方物流 ——【快递鸟】 - 同时，在此进行整理，希望能帮到有需求的博友们，谢谢 …
- 官方文档： 快递鸟 —— 即时查询API
①. 前期准备
集成类的使用
- 首先需要登录 快递鸟
获取账号的
用户ID和API key对所提供源码中的 集成类
BirdExpress.php，进行配置项的替换操作
- 然后
将集成类整合到你的项目框架，根据框架规则进行必要修改（框架不同规则自然多数不同，本人为
ThinkPHP5.1.2）下图为简单的调用测试：
- 注意【2019.06.10 补充】：
测试发现，线上的 linux 系统下无法识别命名空间大小写情况，在此建议 namespace APP\api\controller，都改成小写字母
核心处理方法源码
- 首先，官方的代码
demo获得的物流信息是正序展示的为了方便物流信息的倒序展示，我进行了对数组
Traces的反转操作
/** * 核心方法 * Json方式 查询订单物流轨迹 * @param string $ShipperCode 快递公司编码 * @param string $logisticCode 物流单号 * @param int $arrayFlag 是否进行数组转化标志 默认0：否 1：转化 * 参考规则举例： * $requestData = "{'orderCode':'','ShipperCode':'ZTO','LogisticCode':'640041334612'}"; * @return result 包含即时物流信息的 Json数据 */ public function getOrderTracesByJson($ShipperCode = "",$LogisticCode = "",$arrayFlag = 0) { $requestData = "{ 'OrderCode':'', 'ShipperCode':'$ShipperCode', 'LogisticCode':'$LogisticCode' }"; $postData = array( 'EBusinessID' => $this->EBusinessID, 'RequestType' => '1002',//接口指令1002 'RequestData' => urlencode($requestData), 'DataType' => '2', ); $postData['DataSign'] = $this->encrypt($requestData, $this->AppKey); $result = $this->sendPost($this->ReqURL, $postData); //根据公司业务处理返回的信息...... if ($arrayFlag){ $result = json_decode($result,true); //TODO 方便物流信息的倒序展示，进行数组反转 $result['Traces'] = array_reverse($result['Traces']); } return $result; }
效果展示截图
[重要提示]: 代码逻辑梳理，以及整体业务设计构化
- 通过上面核心源码的展示，你应该会注意到
调用其方法，必须要传入 快递公司编码 和 物流单号 这两个参数
- 好在，官方提供了 快递公司编码， 所以，鄙人的设计思路如下：
1. 根据官方提供的快递公司编码excel表
取出其中的 "快递公司"和"编码"两列数据存储到本地数据表
如果使用的快递数量较集中，可以自己建表输入
如果是通用性的快递使用，建议直接对excel表转化为mysql(或其他数据表)存储
如果需要进行
excel表的导入操作，可直接参考对应文章： ThinkPHP5.1 excel表的导入导出操作 (PHPExcel)
2. 在后台操作人员输入快递单号时
同时要求选择快递公司，获得 "编码"
从而保证，在数据表中，存储的快递单号唯一匹配到一个编码，继而方便后面进行快递信息查询时，可同时获得所需的两个参数.
