PHPackages                             asundust/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. [API Development](/categories/api)
4. /
5. asundust/express

ActiveLibrary[API Development](/categories/api)

asundust/express
================

(2024年维护中)支持快递鸟、快递100的快递查询SDK 支持Laravel

v1.0.0(2y ago)14.1kMITPHP

Since Jan 8Pushed 2y ago1 watchersCompare

[ Source](https://github.com/asundust/express)[ Packagist](https://packagist.org/packages/asundust/express)[ Docs](https://github.com/asundust/dcat-auth-google-2fa)[ RSS](/packages/asundust-express/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

 Express
=========

[](#-express-)

支持快递鸟、快递100的快递查询SDK

[![Build Status](https://camo.githubusercontent.com/4cb81b755693bd82084a725312167cfa68be24c42a3791ef1608dfb3c7faa5bf/68747470733a2f2f7472617669732d63692e6f72672f6173756e647573742f657870726573732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/asundust/express)[![StyleCI build status](https://camo.githubusercontent.com/9afdad803644270bf06f9cb6442e6ff54a8ff927d3708b18c487844bd5b7c29e/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3734303337373731322f736869656c64)](https://github.styleci.io/repos/740377712)[![Latest Stable Version](https://camo.githubusercontent.com/8effa173c2fb44c4cb8b4a5422db586c43d344a97d62548113e368ec9e3122b3/68747470733a2f2f706f7365722e707567782e6f72672f6173756e647573742f657870726573732f762f737461626c65)](https://packagist.org/packages/asundust/express)[![Total Downloads](https://camo.githubusercontent.com/8b5a928f0c757194c43b5fa68ca291847104e93013a1599aaa8c6757b47c4170/68747470733a2f2f706f7365722e707567782e6f72672f6173756e647573742f657870726573732f646f776e6c6f616473)](https://packagist.org/packages/asundust/express)[![License](https://camo.githubusercontent.com/3d38454f76e8f40ce15c385f6339db74a097b54f586681651e000e7cfb428734/68747470733a2f2f706f7365722e707567782e6f72672f6173756e647573742f657870726573732f6c6963656e7365)](https://packagist.org/packages/asundust/express)

Fork声明
------

[](#fork声明)

- **无人维护，接盘维护一下，尽量保证及时维护**

安装
--

[](#安装)

```
$ composer require asundust/express
```

配置
--

[](#配置)

在使用本扩展之前，你需要去 [快递100](https://www.kuaidi100.com/openapi/applyapi.shtml) 或者 [快递鸟](http://www.kdniao.com/reg) 注册申请，获取到APP\_id和APP\_key。

使用
--

[](#使用)

### 快递100

[](#快递100)

```
use Asundust\Express\Express100;

$express = new Express100('app_id','app_key');
$info = $express->track($tracking_code, $shipping_code, $phone); //快递单号 物流公司编号 收件人手机号(顺丰必填 其他快递选填)
```

示例:

```
{
    "message": "ok",
    "nu": "888888888888",
    "ischeck": "1",
    "condition": "F00",
    "com": "shunfeng",
    "status": "200",
    "state": "3",
    "data": [
        {
            "time": "2019-03-08 19:11:51",
            "ftime": "2019-03-08 19:11:51",
            "context": "[安高广场速运营业点]快件已发车"
        },
        {
            "time": "2019-03-08 18:56:12",
            "ftime": "2019-03-08 18:56:12",
            "context": "[安高广场速运营业点]快件在【合肥蜀山区安高广场营业点】已装车,准备发往 【合肥经开集散中心】"
        },
        {
            "time": "2019-03-08 18:50:52",
            "ftime": "2019-03-08 18:50:52",
            "context": "[安高广场速运营业点]顺丰速运 已收取快件"
        }
    ]
}
```

### 快递鸟

[](#快递鸟)

```
use Asundust\Express\ExpressBird;

$express = new ExpressBird('app_id','app_key');
$info = $express->track($tracking_code, $shipping_code，$order_code); //快递单号 物流公司编号 订单编号(选填)
```

示例:

```
{
    "LogisticCode": "8888888888888888",
    "ShipperCode": "YTO",
    "Traces": [
        {
            "AcceptStation": "【四川省直营市场部公司】 取件人: 四川省直营市场部41 已收件",
            "AcceptTime": "2019-03-21 11:03:40"
        },
        {
            "AcceptStation": "【四川省直营市场部公司】 已收件",
            "AcceptTime": "2019-03-21 13:45:01"
        },
        {
            "AcceptStation": "【成都转运中心】 已收入",
            "AcceptTime": "2019-03-21 22:40:01"
        }
    ],
    "State": "3",
    "OrderCode": "",
    "EBusinessID": "100000",
    "Success": true
}
```

### 通用方法

[](#通用方法)

```
use Asundust\Express\Express;

$express = new Express($app_id,$app_key,$type); //$type支持类型'express100'、'expressbird'

//快递鸟$additional=['order_code'=>111111] 快递100 $additional=['phone'=>'18899996666']
$info = $express->track($tracking_code, $shipping_code，$additional); ////查询物流 快递单号 额外参数
```

### 在 Laravel 中使用

[](#在-laravel-中使用)

在 Laravel 中使用也是同样的安装方式，配置写在 `config/services.php` 中：

```
    .
    .
    .
     'express' => [
        'id' => env('EXPRESS_ID'),
        'key' => env('EXPRESS_KEY'),
        'type' => env('EXPRESS_TYPE'),
    ],
```

然后在 `.env` 中配置 `EXPRESS_ID`、`EXPRESS_KEY`、`EXPRESS_TYPE`；

```
EXPRESS_ID=xxxxxxxxxxxxxxxxxxxxx
EXPRESS_KEY=xxxxxxxxxxxxxxxxxxxxx
EXPRESS_TYPE=express100
```

可以用两种方式来获取 `Asundust\Express\Express` 实例：

#### 方法参数注入

[](#方法参数注入)

```
    .
    .
    .
    public function edit(Express $express)
    {
        $response = $express->track('888888888','YTO');
    }
    .
    .
    .
```

#### 服务名访问

[](#服务名访问)

```
    .
    .
    .
    public function edit()
    {
        $response = app('express')->track('888888888','YTO');
    }
    .
    .
    .
```

参考
--

[](#参考)

- [快递100接口文档](https://www.kuaidi100.com/openapi/api_post.shtml)
- [快递100快递公司编码](https://blog.csdn.net/u011816231/article/details/53063611)
- [快递鸟接口文档](http://www.kdniao.com/documents)
- [快递鸟快递公司编码](http://www.kdniao.com/documents)

License
-------

[](#license)

MIT

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 68.4% 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

Unknown

Total

1

Last Release

897d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6573979?v=4)[塵世不再](/maintainers/asundust)[@asundust](https://github.com/asundust)

---

Top Contributors

[![inbjo](https://avatars.githubusercontent.com/u/11854149?v=4)](https://github.com/inbjo "inbjo (13 commits)")[![asundust](https://avatars.githubusercontent.com/u/6573979?v=4)](https://github.com/asundust "asundust (5 commits)")[![todouer](https://avatars.githubusercontent.com/u/73217797?v=4)](https://github.com/todouer "todouer (1 commits)")

---

Tags

expressexpress100expressniaoextensionlaravellaravelextensionexpressexpress100expressniao

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.5M916](/packages/statamic-cms)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3661.2M46](/packages/tencentcloud-tencentcloud-sdk-php)[flat3/lodata

OData v4.01 Producer for Laravel

99346.1k](/packages/flat3-lodata)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

232.5k](/packages/eslazarev-wildberries-sdk)[simplestats-io/laravel-client

Analytics for Laravel. Track visitors, registrations, and payments. Discover which channels actually drive revenue, not just traffic. Server-side, GDPR compliant, ad-blocker proof.

5019.3k](/packages/simplestats-io-laravel-client)[files.com/files-php-sdk

Files.com PHP SDK

2478.1k](/packages/filescom-files-php-sdk)

PHPackages © 2026

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