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可以快速实现快递查询功能，为应用的用户提供更好的服务。