sylapi/courier-ups 问题修复 & 功能扩展

解决BUG、新增功能、兼容多环境部署,快速响应你的开发需求

邮箱:yvsm@zunyunkeji.com | QQ:316430983 | 微信:yvsm316

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 我们能提供哪些服务?
定制开发 / 二次开发

基于 sylapi/courier-ups 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ:316430983 微信:yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

统计信息

  • 总下载量: 1.44k
  • 月度下载量: 0
  • 日度下载量: 0
  • 收藏数: 0
  • 点击次数: 16
  • 依赖项目数: 0
  • 推荐数: 0

GitHub 信息

  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • 开发语言: PHP

其他信息

  • 授权协议: MIT
  • 更新时间: 2024-03-11