ptondereau / laravel-ups-api
PHP UPS API 库的 Laravel 封装
v4.0.0
2024-05-20 13:11 UTC
Requires
- php: ^8.1 || ^8.2 || ^8.3
- gabrielbull/ups-api: ^1.2.2 || ^2.0
- illuminate/contracts: ^8.0 || ^9.0 || ^10.0 || ^11.0
- illuminate/support: ^8.0 || ^9.0 || ^10.0 || ^11.0
Requires (Dev)
- graham-campbell/analyzer: ^4.1
- graham-campbell/testbench: ^6.1
- phpunit/phpunit: ^10.5.20
README
适用于 Laravel 10 和 11
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) 许可。