Download the PHP package m4dev/laravel-usps without Composer

On this page you can find all versions of the php package m4dev/laravel-usps. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of m4dev/laravel-usps

Informations about the package laravel-usps

USPS Laravel Package

A comprehensive Laravel package for USPS shipping integration with support for address validation, rate calculation, label creation, and package tracking using the USPS API v3 with OAuth2 authentication.

Features

Requirements

Installation

  1. Install via Composer:

  2. Publish the configuration file:

  3. Run the migrations:

  4. Configure your environment variables in .env:

Getting USPS API Credentials

  1. Go to the USPS Developer Portal
  2. Create an account or log in
  3. Register your application
  4. You'll receive a client_id and client_secret
  5. Use these credentials in your .env file

Note: The modern USPS API v3 uses OAuth2 authentication with client credentials, not API keys.

Quick Start

Basic Usage Example

Detailed Usage

Address Validation

Getting Shipping Rates

Creating Shipping Labels

Package Tracking

Using the Facade

Artisan Commands

Test USPS Connection

Update Tracking Information

Clean Up Expired Cache

Configuration Options

Service Types

Configure available USPS services in config/usps.php:

Rate Shopping

Enable automatic rate comparison:

Caching

Configure rate caching:

Working with Models

UspsShipment Model

Advanced Usage

Batch Operations

Custom Exception Handling

Controller Example

Testing

Run the test suite:

Environment Setup for Testing

Create a .env.testing file:

Scheduled Tasks

Add to your app/Console/Kernel.php to automatically update tracking:

Error Handling Best Practices

  1. Always validate addresses before creating labels
  2. Handle rate limits with proper delays between requests
  3. Cache rates to reduce API calls
  4. Log errors for debugging and monitoring
  5. Use try-catch blocks around all USPS API calls

API Rate Limits

The USPS API has rate limits. The package includes:

Troubleshooting

Common Issues

  1. Authentication Errors: Verify your client_id and client_secret are correct
  2. Address Validation Failures: Ensure addresses are properly formatted
  3. Rate Errors: Check weight and dimension limits for selected service
  4. Label Creation Failures: Verify all required address fields are provided

Debug Mode

Enable debug logging in your .env:

Support

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This package is open-sourced software licensed under the [MIT license] (LICENSE.md).

Changelog

v1.0.0

All versions of laravel-usps with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
laravel/framework Version ^10.0|^11.0|^12.0
ext-curl Version *
ext-json Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package m4dev/laravel-usps contains the following files

Loading the files please wait ...