25 Star 71 Fork 12

DEPRECATED / 查快递

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

Kuaidi - 免费快递查询扩展包

已弃用,请关注新项目:https://github.com/finecho/logistics

📦 集成「快递100」、「快递网」、「快递鸟」三家快递查询接口,并统一调用方式。

❤️ 本项目 GitHub / Gitee(码云)

Build Status StyleCI Packagist

小试牛刀

注意:本扩展包内所有快递公司名称,均不带结尾 物流 / 快递 / 快运 / 速递 / 速运 等字眼。

克隆本仓库,并执行 composer install 安装所需依赖。

在命令行内运行。

php examples/index.php <运单编号> [快递公司名称]

其中,快递公司名称可省略;效果如下:

使用方法

0. 安装

composer require wi1dcard/kuaidi

1. 创建运单

$waybill = new \Kuaidi\Waybill(
    '运单编号', 
    '快递公司名称'
);

「快递100」支持自动识别,可不填快递公司名称。

2. 查询

(new \Kuaidi\Trackers\Kuaidi100)->track($waybill);
(new \Kuaidi\Trackers\Kuaidiwang)->track($waybill);
(new \Kuaidi\Trackers\Kuaidiniao('Business ID', 'APP Key'))->track($waybill);

通常三选一即可,推荐使用「快递100」。

若查询过程出错,或接口返回失败将会抛出 Kuaidi\TrackingException

3. 获得数据

// 获取状态,所有状态列表见 `Waybill::STATUS_*` 常量。
$waybill->getStatus();
// 获取详情,支持直接 foreach / while / 数组下标 形式访问。
$waybill->getTraces(); 

实际项目中,可自行封装辅助函数以便于使用。

结语

这个扩展包的初衷,是因为各家快递查询接口支持的快递公司不同,有部分接口不稳定 / 缺失小众快递公司的支持;公司产品需要稳定且支持率高,所以封装出来一套比较统一的快递查询接口,包装各家的 API,也方便以后进行扩展。

目前已经在生产环境稳定使用三个月左右,解除无关依赖后修改放出,供大家参考使用。

如果你有新的公共接口 / 原有接口出现问题,欢迎 Issue 和 PR,不胜感激。

关于命名,考虑到国内外环境差距大,此扩展包多数只在国内使用;所以干脆用本地化的词语,简单好记:Kuaidi

声明

接口来源于网络,本扩展包仅为包装和收集,仅供学习参考;对于数据准确性、接口可用性不作保证;一切法律问题自行承担。

MIT License Copyright (c) 2018 Wi1dcard Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

集成「快递100」、「快递网」、「快递鸟」三家快递查询接口,并统一调用方式。 展开 收起
PHP
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
PHP
1
https://gitee.com/wi1dcard/kuaidi.git
git@gitee.com:wi1dcard/kuaidi.git
wi1dcard
kuaidi
查快递
master

搜索帮助