README

一个简单的工具，用于抓取DHL、DHL Express、GLS、UPS、FedEx、USPS、瑞士邮政服务和奥地利邮政服务的包裹跟踪数据

一些包裹服务在注册商家或开发者账户时非常麻烦。您实际上只想简单地跟踪运输并关注其状态。是的，您可以不断刷新跟踪页面，但有时您有更重要的事情要做。

所以这里有一个工具可以自动完成这项工作，没有任何开发者账户和API的复杂术语。它只是简单地抓取包含跟踪信息的网站，并将数据转换为人类和计算机易于消费的格式。让我向您展示它是如何工作的！

安装

只需通过composer或将其添加到您的composer.json文件中引入此软件包

$ composer require ansas/shipment-tracker

别忘了之后运行

$ composer update

。

支持的承运商

该软件包目前支持以下承运商和语言

• DHL (de, en)
• DHL Express (de, en)（目前仅针对运单号码，不针对单个件货物的运输号码）
• GLS (de, en)
• UPS (de, en)
• Fedex (en)（感谢 @avrahamappel）
• USPS (en)
• PostCH (Swiss Post Service) (de, en)
• PostAT (Austria Post Service) (de, en)

基本用法

require_once 'vendor/autoload.php';

use Sauladam\ShipmentTracker\ShipmentTracker;

$dhlTracker = ShipmentTracker::get('DHL');

/* track with the standard settings */
$track = $dhlTracker->track('00340434127681930812');
// scrapes from http://nolp.dhl.de/nextt-online-public/set_identcodes.do?lang=de&idc=00340434127681930812

/* override the standard language */
$track = $dhlTracker->track('00340434127681930812', 'en');
// scrapes from http://nolp.dhl.de/nextt-online-public/set_identcodes.do?lang=en&idc=00340434127681930812

/* pass additional params to the URL (or override the default ones) */
$track = $dhlTracker->track('00340434127681930812', 'en', ['zip' => '12345']);
// scrapes from http://nolp.dhl.de/nextt-online-public/set_identcodes.do?lang=en&idc=00340434127681930812&zip=12345

就是这样。让我们检查这个包裹是否已经送达

if($track->delivered())
{
    echo "Delivered to " . $track->getRecipient();
}
else
{
    echo "Not delivered yet, The current status is " . $track->currentStatus();
}

可能的状态有

• Track::STATUS_IN_TRANSIT
• Track::STATUS_DELIVERED
• Track::STATUS_PICKUP
• Track::STATUS_EXCEPTION
• Track::STATUS_WARNING
• Track::STATUS_UNKNOWN

那么现在它在哪，发生了什么？

$latestEvent = $track->latestEvent();

echo "The parcel was last seen in " . $latestEvent->getLocation() . " on " . $latestEvent->getDate()->format('Y-m-d');
echo "What they did: " . $latestEvent->description();
echo "The status was " . $latestEvent->getStatus();

您可以使用$track->events()获取整个事件历史记录的数组。事件按日期降序排列。日期是Carbon对象。

还有其他什么吗？

您只想构建跟踪网站的URL？没问题

$url = $dhlTracker->trackingUrl('00340434127681930812');
// http://nolp.dhl.de/nextt-online-public/set_identcodes.do?lang=de&idc=00340434127681930812

哦，您需要将其链接到英文版本？当然可以

$url = $dhlTracker->trackingUrl('00340434127681930812', 'en');
// http://nolp.dhl.de/nextt-online-public/set_identcodes.do?lang=en&idc=00340434127681930812

“但等等，如果我需要带有附加参数的该URL怎么办？” - 好吧，只需传递它们即可

$url = $dhlTracker->trackingUrl('00340434127681930812', 'en', ['zip' => '12345']);
// http://nolp.dhl.de/nextt-online-public/set_identcodes.do?lang=en&idc=00340434127681930812&zip=12345

其他功能

附加详情

跟踪和事件都可以保存附加详情，可以通过例如$track->getAdditionalDetails('foo')访问。目前，这仅适用于GLS和UPS

• GLS

  • $track->getAdditionalDetails('parcelShop')获取包裹店的详细信息以及如果包裹已送达的营业时间

• UPS

  • $track->getAdditionalDetails('accessPoint')获取如果包裹已送达的接入点的地址
  • $track->getAdditionalDetails('pickupDueDate')获取作为Carbon实例的取货截止日期

• DHL Express (运单)

  • $track->getAdditionalDetails('pieces')获取属于此运输的各个件货物的跟踪号码
  • $event->getAdditionalDetails('pieces')获取此事件适用的各个件货物的跟踪号码

• FedEx

  • $track->getAdditionalDetails('totalKgsWgt')如果退货，则获取运输重量的千克数
  • $track->getAdditionalDetails('totalLbsWgt') 获取货物的重量（以磅为单位），如果返回则有效。

数据提供者

默认情况下，此包使用 Guzzle 以及 PHP Http 客户端（即 file_get_contents()）来获取数据。如果您需要，可以传递自己的提供者，例如，如果您在缓存中某处有页面内容。只需确保它实现了 Sauladam\ShipmentTracker\DataProviders\DataProviderInterface，该接口只需要一个 get() 方法。

然后，您可以直接将其传递给工厂： $dhlTracker = ShipmentTracker::get('DHL', new CacheDataProvider);

如果您传递了数据提供者，它将默认使用，但您以后如果想的话可以替换它。

$dhlTracker->useDataProvider('guzzle');

目前可用的提供者包括

• guzzle
• php
• 自定义（指您传递的提供者）

注意事项

请注意，这只是一个使您生活更轻松的工具。我不建议在关键环境中使用它，因为由于它的运作方式，一旦数据提取的跟踪网站更改了其结构或重新命名/改写事件描述，它可能会崩溃。因此，请 自行承担风险使用！

此外，有可能无法解析状态，即使该包已正确解析最常见的活动，因为该包不认识事件描述。

此外，跟踪数据，因此该包提供的数据，是承运人的财产（我想），因此您绝对不应该将其用于商业目的（如出售或将其集成到商业服务中）。它仅供个人使用。