ptondereau/laravel-ups-api

PHP UPS API 库的 Laravel 封装

v4.0.0 2024-05-20 13:11 UTC

This package is auto-updated.

Last update: 2024-09-20 13:49:19 UTC


README

适用于 Laravel 10 和 11

Build Status StyleCI Status Software License Packagist Downloads Latest Version

Laravel UPS Api 由 Pierre Tondereau 创建并维护,PHP UPS Api 由 Gabriel Bull 创建并维护,地址为 PHP UPS API

安装

要获取 Laravel UPS Api 的最新版本,只需使用 Composer 引入项目即可

$ composer require ptondereau/laravel-ups-api

当然,您也可以手动更新 require 块并运行 composer update

{
    "require": {
        "ptondereau/laravel-ups-api": "^1.0"
    }
}

UpsApiServiceProvider 默认会自动发现并注册。如果需要,您可以手动在 config/app.php 文件中添加以下内容进行注册。

  • 'Ptondereau\LaravelUpsApi\UpsApiServiceProvider'

您可以在 config/app.php 文件的 aliases 键中注册所有或部分 Ups Facades。

  • 'UpsAddressValidation' => 'Ptondereau\LaravelUpsApi\Facades\UpsAddressValidation'
  • 'UpsLocator' => 'Ptondereau\LaravelUpsApi\Facades\UpsLocator'
  • 'UpsQuantumView' => 'Ptondereau\LaravelUpsApi\Facades\UpsQuantumView'
  • 'UpsRate' => 'Ptondereau\LaravelUpsApi\Facades\UpsRate'
  • 'UpsTimeInTransit' => 'Ptondereau\LaravelUpsApi\Facades\UpsTimeInTransit'
  • 'UpsTracking' => 'Ptondereau\LaravelUpsApi\Facades\UpsTracking'
  • 'UpsTradeability' => 'Ptondereau\LaravelUpsApi\Facades\UpsTradeability'
  • 'UpsShipping' => 'Ptondereau\LaravelUpsApi\Facades\UpsShipping'
  • 'UpsRateInTransit' => 'Ptondereau\LaravelUpsApi\Facades\UpsRateInTransit'

配置

Laravel UPS Api 需要连接配置。

要开始,您需要发布所有供应商资源

$ php artisan vendor:publish --provider="Ptondereau\LaravelUpsApi\UpsApiServiceProvider"

这将在您的应用中创建一个 config/ups.php 文件,您可以修改它来设置配置。同时,请确保检查该包在各个版本之间的原始配置文件变更。

您还需要在 .env 文件中添加您的凭据作为环境变量

UPS_ACCESS_KEY=key
UPS_USER_ID=userId
UPS_PASSWORD=password
UPS_SANDBOX=true

使用

此包仅注入并提供 PHP UPS API 的每个类的 Facades。您只需阅读其文档即可。

更多信息

此包中还有一些未在此处记录的类。这是因为它们不是供公共使用的,而是由本包内部使用的。

安全

如果您在此包中发现安全漏洞,请向 Pierre Tondereau 发送电子邮件至 pierre.tondereau@gmail.com。所有安全漏洞都将得到及时处理。

许可证

Laravel Ups Api 使用 MIT 许可证 (MIT) 许可。