TP5快递SDK是基于ThinkPHP5框架开发的一个快递查询接口，可以快速集成到自己的应用中，实现快递查询功能。下面将对TP5快递SDK的原理和详细介绍进行说明。
一、原理
TP5快递SDK是利用快递100提供的API接口实现的，通过发送HTTP请求获取快递信息，并将返回的JSON数据进行解析，最终返回给调用方。快递100提供的API接口需要传递快递公司编码和快递单号两个参数，通过这两个参数可以查询到该快递的详细信息。
二、详细介绍
1. 安装
首先需要在composer.json文件中添加tp5-express-sdk的依赖
```
require: {
php: >=5.4.0,
topthink/think: 5.0.*,
topthink/think-captcha: ^2.0,
topthink/think-validate: ^2.0,
topthink/think-queue: ^2.0,
topthink/think-worker: ^2.0,
topthink/think-session: ^2.0,
topthink/think-cache: ^2.0,
topthink/think-log: ^2.0,
topthink/think-db: ^2.0,
topthink/think-migration: ^2.0,
topthink/think-view: ^2.0,
topthink/think-route: ^2.0,
topthink/think-swagger: ^2.0,
topthink/think-queue: ^2.0,
topthink/think-orm: ^2.0,
topthink/think-mongo: ^2.0,
topthink/think-redis: ^2.0,
topthink/think-swoole: ^2.0,
topthink/think-wxwork: ^2.0,
topthink/think-wechat: ^2.0,
topthink/think-cors: ^2.0,
jason-zoo/tp5-express-sdk: ^1.0
},
```
然后执行composer update命令进行安装。
2. 配置
在config目录下新建一个express.php配置文件，配置快递100的appkey和appsecret
```
return [
'appkey' => 'xxxxxxxxxxxxxxxxxxxxxxxx',
'appsecret' => 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
];
```
3. 使用
在控制器中引入Tp5ExpressSdk类，调用query方法即可查询快递信息
```
namespace app\index\controller;
use jasonzoo\Tp5ExpressSdk;
class Index
{
public function index()
{
$express = new Tp5ExpressSdk();
$result = $express->query('shentong', '1234567890');
dump($result);
}
}
```
其中，'shentong'是快递公司编码，'1234567890'是快递单号。
4. 返回结果
查询成功后，会返回一个JSON格式的数据，包含快递单号、快递公司、快递状态等信息。以下是一个返回结果的示例
```
{
message: ok,
nu: 1234567890,
ischeck: 1,
condition: F00,
com: shentong,
status: 200,
state: 3,
data: [
{
time: 2021-01-01 12:00:00,
ftime: 2021-01-01 12:00:00,
context: 已签收，感谢使用顺丰，期待再次为您服务,
location:
},
{
time: 2021-01-01 09:00:00,
ftime: 2021-01-01 09:00:00,
context: 快件派送中，派件人:XXX，电话:XXX,
location:
},
{
time: 2021-01-01 08:00:00,
ftime: 2021-01-01 08:00:00,
context: 快件已到达XXX，准备派送,
location:
},
{
time: 2021-01-01 05:00:00,
ftime: 2021-01-01 05:00:00,
context: 快件已到达XXX，正在分拣中,
location:
},
{
time: 2021-01-01 03:00:00,
ftime: 2021-01-01 03:00:00,
context: 快件已到达XXX，正在进行装车扫描,
location:
},
{
time: 2021-01-01 00:00:00,
ftime: 2021-01-01 00:00:00,
context: 您的订单已经进入顺丰扫描环节，请耐心等待,
location:
}
]
}
```
以上就是TP5快递SDK的原理和详细介绍，通过TP5快递SDK可以快速实现快递查询功能，为应用的用户提供更好的服务。