PHPackages                             zhlhuang/express - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. zhlhuang/express

ActiveLibrary[Utility & Helpers](/categories/utility)

zhlhuang/express
================

快递查询

1.3.1(5y ago)765MITPHPCI failing

Since Oct 6Pushed 5y ago1 watchersCompare

[ Source](https://github.com/zhlhuang/express)[ Packagist](https://packagist.org/packages/zhlhuang/express)[ RSS](/packages/zhlhuang-express/feed)WikiDiscussions master Synced today

READMEChangelog (6)Dependencies (3)Versions (7)Used By (0)

express
=======

[](#express)

快递查询（基于快递100），能够让你省钱的对接方式。

[![Build Status](https://camo.githubusercontent.com/76a72f46831ef74bfd7b4591e8fa4dd767a6fea0514eb0da4613dca34ac5b56d/68747470733a2f2f7472617669732d63692e6f72672f7a686c6875616e672f657870726573732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/zhlhuang/express)[![StyleCI](https://camo.githubusercontent.com/dc6dbf0f1ff8d7b36e62b8534c0dcca8f3639654c580aff87fdbb0a97f7ed4b7/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3135313830343134362f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/151804146)

安装
--

[](#安装)

```
$ composer require zhlhuang/express -vvv
```

使用
--

[](#使用)

### 免费接口

[](#免费接口)

```
use Zhlhuang\Express\Express;

$express = new Express();
$express->query('jd', '78785333107', 'json');
```

### 快递100企业版本

[](#快递100企业版本)

**PS:优先调用免费版本，查不到信息或者调用失败的时候会继续调用企业版本**

```
use Zhlhuang\Express\Express;

//快递100免费版已不可调用，建议使用快递鸟
$kuaidiFree = new KuaidiFree();
//实例化企业版本的对象
$kuaidiCompany = new KuaidiCompany([
    'customer' => 'customercustomer',
    'key'      => 'keykeykey'
]);
//实例化聚合数据
$juheExp = new JuheExp([
    'key'      => 'keykeykey'
]);

//实例化快递鸟，支持申通，圆通，中通免费
$Kdniao = new Kdniao([
    'EBusinessID' => '123',
    'key'         => 'key-123-123'
]);

$express = new Express([$Kdniao, $kuaidiCompany, $juheExp]);
$express->query('jd', '78785333107', 'json');
```

正常响应
----

[](#正常响应)

```
{
	"message": "ok",
	"nu": "532071843804", //单号
	"ischeck": "1",//是否签收标记
	"condition": "F00",
	"com": "lianhaowuliu", //快递公司编码,一律用小写字母
	"status": "200",
	"state": "3", //快递单当前签收状态，包括0在途中、1已揽收、2疑难、3已签收
	"data": [{
		"time": "2018-07-17 11:26:35", //时间，原始格式
		"ftime": "2018-07-17 11:26:35", //格式化后时间
		"context": "已签收,签收人是【】签收图片",
		"location": ""
	}, {
		"time": "2018-07-17 08:30:20",
		"ftime": "2018-07-17 08:30:20",
		"context": "【龙华】的【梁献新】正在派件,扫描员是【梁献新】",
		"location": ""
	}, {
		"time": "2018-07-17 06:37:45",
		"ftime": "2018-07-17 06:37:45",
		"context": "快件到达【龙华】上一站是【深圳分拨中心】,扫描员是【杨广 】",
		"location": ""
	}, {
		"time": "2018-07-17 01:10:14",
		"ftime": "2018-07-17 01:10:14",
		"context": "由【SZB046】,扫描发往 【龙华】",
		"location": ""
	}, {
		"time": "2018-07-17 01:00:07",
		"ftime": "2018-07-17 01:00:07",
		"context": "快件到达【深圳分拨中心】上一站是【深圳分拨中心】,扫描员是【陈封优 】",
		"location": ""
	}]
}
```

快递公司编码
------

[](#快递公司编码)

```
申通="shentong"
EMS="ems"
顺丰="shunfeng"
圆通="yuantong"
中通="yuantong"
韵达="yunda"
天天="tiantian"
汇通="huitongkuaidi"
全峰="quanfengkuaidi"
德邦="debangwuliu"
宅急送="zhaijisong"
京东="jd"

```

License
-------

[](#license)

MIT

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 96.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~142 days

Recently: every ~166 days

Total

6

Last Release

2064d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b4d5c961cc47e3e316c7f99ff787f956e18f69ea7cdb6db0e956939f72f65556?d=identicon)[zhlhuang](/maintainers/zhlhuang)

---

Top Contributors

[![zhlhuang](https://avatars.githubusercontent.com/u/6230834?v=4)](https://github.com/zhlhuang "zhlhuang (31 commits)")[![Jayin](https://avatars.githubusercontent.com/u/2763894?v=4)](https://github.com/Jayin "Jayin (1 commits)")

### Embed Badge

![Health badge](/badges/zhlhuang-express/health.svg)

```
[![Health](https://phpackages.com/badges/zhlhuang-express/health.svg)](https://phpackages.com/packages/zhlhuang-express)
```

###  Alternatives

[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)