mobius1 / laravel-ups-api
A fork of Pierre Tondereau's UPS wrapper for Laravel 5.8.*
Requires
- php: >=5.5.9
- gabrielbull/ups-api: ^0.7.6
- illuminate/contracts: ~5.1.0|~5.2.0|~5.3.0|~5.4.0|~5.5.0|~5.6.0|~5.7.0
- illuminate/support: ~5.1.0|~5.2.0|~5.3.0|~5.4.0|~5.5.0|~5.6.0|~5.7.0
Requires (Dev)
- codeclimate/php-test-reporter: ^0.3.0
- graham-campbell/testbench: ^3.0|^4.0|^5.0
- phpunit/phpunit: ^4.8|^5.0|^6.0|^7.0
README
For Laravel 5.8+
Fork of Laravel UPS Api was created by, and maintained by Pierre Tondereau, and PHP UPS Api was created by, and is maintained by Gabriel Bull at PHP UPS API.
Installation
Either PHP 5.5+ or HHVM 3.6+ are required.
To get the latest version of Laravel UPS Api, simply require the project using Composer:
$ composer require mobius1/laravel-ups-api
Instead, you may of course manually update your require block and run composer update if you so choose:
{
"require": {
"mobius1/laravel-ups-api": "^1.0"
}
}
Once Laravel UPS Api is installed, you need to register the service provider. Open up config/app.php and add the following to the providers key.
'Ptondereau\LaravelUpsApi\UpsApiServiceProvider'
You can register the all or some Ups facade in the aliases key of your config/app.php file if you like.
'UPSAddressValidator' => 'Ptondereau\LaravelUpsApi\Facades\UpsAddressValidator''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'
Configuration
Laravel UPS Api requires connection configuration.
To get started, you'll need to publish all vendor assets:
$ php artisan vendor:publish --provider="Ptondereau\LaravelUpsApi\UpsApiServiceProvider"
This will create a config/ups.php file in your app that you can modify to set your configuration. Also, make sure you check for changes to the original config file in this package between releases.
You also need to add env variables into your .env with your credentials:
UPS_ACCESS_KEY=key
UPS_USER_ID=userId
UPS_PASSWORD=password
UPS_SANDBOX=true
Usage
This package only inject and provide Facades for each class of PHP UPS API. You just have to read its documentation.
Further Information
There are other classes in this package that are not documented here. This is because they are not intended for public use and are used internally by this package.
Security
If you discover a security vulnerability within this package, please send an e-mail to Pierre Tondereau at me@pierre-tondereau.com. All security vulnerabilities will be promptly addressed.
License
Laravel Ups Api is licensed under The MIT License (MIT).