sylapi/courier-ups
Composer 安装命令:
composer require sylapi/courier-ups
包简介
Courier UPS
README 文档
README
Init
$courier = \Sylapi\Courier\CourierFactory::create('Ups',[ 'login' => 'client_id', 'password' => 'secret', 'sandbox' => true, 'shipperNumber' =>'1234AB', 'shipperCountryCode' => 'PL', 'transId' => 'string', //OPTIONAL 'transactionSrc' => 'testing' //OPTIONAL ]);
CreateShipment
$sender = $courier->makeSender(); $sender->setFullName('Nazwa Firmy/Nadawca') ->setStreet('Ulica') ->setHouseNumber('2a') ->setApartmentNumber('1') ->setCity('Miasto') ->setZipCode('66100') ->setCountry('Poland') ->setCountryCode('PL') ->setContactPerson('Jan Kowalski') ->setEmail('my@email.com') ->setPhone('48500600700'); $receiver = $courier->makeReceiver(); $receiver->setFirstName('Piotr') ->setSurname('Nowak') ->setStreet('Ulica') ->setHouseNumber('3') ->setApartmentNumber('') ->setCity('Miasto') ->setZipCode('66200') ->setCountry('Poland') ->setCountryCode('PL') ->setProvince('Bacau') ->setContactPerson('Piotr Nowak') ->setEmail('piotr.nowak@sylapi.com') ->setPhone('48500100200'); /** * @var \Sylapi\Courier\Ups\Entities\Parcel $parcel */ $parcel = $courier->makeParcel(); $parcel->setWeight(5) ->setLength(10) ->setWidth(10) ->setHeight(10) ->setContainerCode(ContainerCode::PACKAGE->value); $options = $courier->makeOptions(); $options->setSpeditionCode(\Sylapi\Courier\Ups\Enums\SpeditionCode::UPS_STANDARD->value) ->setPackagingCode(\Sylapi\Courier\Ups\Enums\PackagingCode::TRANSPORTATION->value) ->setRequestOption(\Sylapi\Courier\Ups\Enums\RequestOption::NON_VALIDATE->value); $shipment = $courier->makeShipment(); $shipment->setSender($sender) ->setReceiver($receiver) ->setParcel($parcel) ->setContent('Content') ->setReferenceId('1234567890') ->setOptions($options); try { $response = $courier->createShipment($shipment); var_dump($response->getReferenceId()); // Utworzony wewnetrzny idetyfikator zamowienia var_dump($response->getShipmentId()); // Zewnetrzny idetyfikator zamowienia } catch (\Exception $e) { var_dump($e->getMessage()); }
PostShipment
try { /** * @var \Sylapi\Courier\Ups\Entities\Booking $booking */ $booking = $response->getBooking(); $booking->setPickupDateTime('YYYYMMDD', 'HHmm', 'HHmm'); $pickupAddress = $booking->getPickupAddress(); $pickupAddress->setFullName('Nazwa Firmy/Nadawca') ->setStreet('Ulica') ->setHouseNumber('2a') ->setApartmentNumber('1') ->setCity('Miasto') ->setZipCode('66100') ->setCountry('Poland') ->setCountryCode('PL') ->setContactPerson('Jan Kowalski') ->setEmail('my@email.com') ->setPhone('48500600700'); ->setResidentialIndicator(false) ->setPickupPoint('Lobby'); $booking->setPickupAddress($pickupAddress); $booking->addShipment($shipment); $response = $courier->postShipment($booking); var_dump($response->getShipmentId()); // Zewnetrzny idetyfikator zamowienia } catch (\Exception $e) { var_dump($e->getMessage()); }
GetStatus
try { $responseStatus = $courier->getStatus($response->getShipmentId()); var_dump((string )$responseStatus); var_dump(($responseStatus->getStatusName())); var_dump(($responseStatus->getOriginalStatusName())); } catch (\Exception $e) { var_dump($e->getMessage()); }
GetLabel
try { $labelType = $courier->makeLabelType(); $response = $courier->getLabel($response->getShipmentId(), $labelType); echo ((string) $response); } catch (\Exception $e) { var_dump($e->getMessage()); }
Komendy
| KOMENDA | OPIS |
|---|---|
| composer tests | Testy |
| composer phpstan | PHPStan |
| composer coverage | PHPUnit Coverage |
| composer coverage-html | PHPUnit Coverage HTML (DIR: ./coverage/) |
sylapi/courier-ups 适用场景与选型建议
sylapi/courier-ups 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 1.44k 次下载、GitHub Stars 达 0, 最近一次更新时间为 2024 年 03 月 11 日, 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向: 「shipping」 「ups」 「courier」 等业务场景。在实际项目中,围绕这些方向常见需要落地的问题包括:接口对接、性能调优、并发安全、与既有框架(Laravel / ThinkPHP / Yii / Webman 等)的兼容适配,以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 sylapi/courier-ups 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。
基于 sylapi/courier-ups 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。
与 sylapi/courier-ups 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐,方便对比选型:
统计信息
- 总下载量: 1.44k
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 0
- 点击次数: 16
- 依赖项目数: 0
- 推荐数: 0
其他信息
- 授权协议: MIT
- 更新时间: 2024-03-11