README

快递鸟 快递查询接口封装，逐步完善中...

安装

$ composer require xin6841414/express_bird

配置

1. 在 config/app.php 注册 ServiceProvider (Laravel 5.5 + 无需手动注册)：

   'providers' => [
       // ...
       Xin6841414\ExpressBird\ExpressBirdServiceProvider::class,
   ],

2. 创建配置文件：

   $ php artisan vendor:publish --provider="Xin6841414\ExpressBird\ExpressBirdServiceProvider"

3. 修改应用根目录下的 config/express_bird.php 中对应的参数即可。

使用

1. 在控制器中使用

namespace App\Http\Controllers;

use Xin6841414\ExpressBird\ExpressBird;  //注入时用
use Xin6841414\ExpressBird\Facades\ExpressBird;  //门面用



class TestController extends Controller
{
    
     public function index(ExpressBird $expressBird)  
     {
       
         $result1 = $expressBird->realTimeQuery('777424831256386', 'STO');
         $result2 = app('express_bird')->realTimeQuery('777424831256386', 'STO');
         $result3 = ExpressBird::realTimeQuery('777424831256386', 'STO');
#         //$result:  {
#  "EBusinessID" : "1363938",
#  "ShipperCode" : "STO",
#  "LogisticCode" : "777424831256386",
#  "Location" : "青岛市",
#  "State" : "3",
#  "StateEx" : "302",
#  "Traces" : [ {
#    "Action" : "302",
#    "AcceptStation" : "已签收，签收人凭取货码签收。，可关注“申通快递”官方微信公众号获取实时物流信息",
#    "AcceptTime" : "2026-07-09 11:36:42",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "412",
#    "AcceptStation" : "快件已暂存至菜鸟驿站，如有疑问请联系13863998589，如有取件码问题或找不到包裹等问题，请联系：快递员【18661653919】，投诉电话【053285294663】，营业时间【08:00-20:30】，可关注“申通快递”官方微信公众号获取实时物流信息",
#    "AcceptTime" : "2026-07-08 16:23:04",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "202",
#    "AcceptStation" : " 【青岛市】山东青岛李沧区东部公司 的快递员(张三/13800138000)正在为您派送，【物流问题无需找商家或平台，请致电（053285294663）或专属渠道95543更快解决】，可关注“申通快递”官方微信公众号获取实时物流信息",
#    "AcceptTime" : "2026-07-08 16:03:31",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "202",
#    "AcceptStation" : " 【青岛市】山东青岛李沧区东部公司 的快递员(张三/13800138000)正在为您派送，【物流问题无需找商家或平台，请致电（053285294663）或专属渠道95543更快解决】，可关注“申通快递”官方微信公众号获取实时物流信息",
#    "AcceptTime" : "2026-07-08 14:23:23",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "2",
#    "AcceptStation" : "【青岛市】快件已到达 山东青岛李沧区东部公司 ，【物流问题无需找商家或平台，请致电（053285294663）或专属渠道95543更快解决】",
#    "AcceptTime" : "2026-07-08 14:22:32",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "2",
#    "AcceptStation" : "【青岛市】快件已发往 山东青岛李沧区东部公司，【物流问题无需找商家或平台，请致电专属渠道95543更快解决】",
#    "AcceptTime" : "2026-07-08 09:08:03",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "2",
#    "AcceptStation" : "【青岛市】快件已到达 山东青岛转运中心 ",
#    "AcceptTime" : "2026-07-08 08:51:14",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "2",
#    "AcceptStation" : "【郑州市】快件已发往 山东青岛转运中心",
#    "AcceptTime" : "2026-07-07 20:54:27",
#    "Location" : "郑州市"
#  }, {
#    "Action" : "2",
#    "AcceptStation" : "【郑州市】快件已到达 河南郑州转运中心 ",
#    "AcceptTime" : "2026-07-07 20:51:55",
#    "Location" : "郑州市"
#  }, {
#    "Action" : "2",
#    "AcceptStation" : "【商丘市】快件已发往 河南郑州转运中心，若出现揽收后物流长时间未更新，请及时联系我们（【03702302699】或官方客服95543）核实，专属客服帮你跟进解决",
#    "AcceptTime" : "2026-07-07 15:33:56",
#    "Location" : "商丘市"
#  }, {
#    "Action" : "1",
#    "AcceptStation" : "【商丘市】河南夏邑县公司(03xxxx99)的出港扫描台(16xxxx798) 已揽收，若出现揽收后物流长时间未更新，请及时联系我们（【037xxxxx99】或官方客服95543）核实，专属客服帮你跟进解决",
#    "AcceptTime" : "2026-07-07 15:05:33",
#    "Location" : "商丘市"
#  } ],
#  "DeliveryManTel" : "13800138000",
#  "Success" : true
#}

        
     } 
 
}
    

其他接口陆续完善中...

鸣谢

overtruele/easy-sms