README

从 https://github.com/smartameer/laravel-usps 分支 Fork 并更新以支持 Laravel 5.4

Laravel-USPS

Laravel-USPS 是一个 composer 包，允许您集成 USPS 地址/运输 API。此包是从 @author Vincent Gabriel 的 https://github.com/VinceG/USPS-php-api 端移植过来的。

需要有效的 USPS API 用户名
已在 Laravel 5+ 上进行测试

安装

首先通过 Composer 安装此包。在终端运行以下命令

composer require mpinchuk/laravel-usps:dev-master

Laravel 集成

要在您的 Laravel 项目中设置此功能，您需要添加服务提供者。打开 config/app.php，并将新项添加到 providers 数组中。

'Usps\UspsServiceProvider',

然后您还必须在 config/app.php 中指定别名。将新项添加到 Aliases 数组中。

'Usps' => 'Usps\Facades\Usps',

这将允许通过添加 Facade Use Usps; 进行集成

Laravel 配置

在 config/services.php 中添加您的 USPS 用户名配置。

'usps' => [
		'username' => "XXXXXXXXXXXX"
	]

示例控制器使用

Laravel 完成的唯一方法是 Usps::validate，它在 vendor/mpinchuk/laravel-usps/src/Usps/Usps.php 中定义。由于此包是用于内部使用开发的，我没有引入所有功能，但您完全可以贡献您需要的功能方法，我将合并它们。我建议查看 @VinceG 的原始 PHP 包装器 USPS PHP-Api，因为我已经将这些类移植并自动加载到 Usps.php 文件中。

<?php

namespace app\Http\Controllers;
use app\Http\Requests;
use app\Http\Controllers\Controller;
use Illuminate\Support\Facades\Request;
use Usps;

class USPSController extends Controller
{
    public function index() {
        return response()->json(
            Usps::validate( 
                Request::input('Address'), 
                Request::input('Zip'), 
                Request::input('Apartment'), 
                Request::input('City'), 
                Request::input('State')
            )
        );
    }
}

@VinceG 原始 README.MD

USPS PHP API

此包装器允许您对 USPS API 执行一些基本调用。目前支持的功能包括

计费计算器（国内和国际）
按地址查找邮政编码
按邮政编码查找城市/州
验证地址
创建优先级运输标签
创建开放并分发运输标签
创建国际运输标签（快递、优先、平邮）
服务交付计算器
确认跟踪

要求

PHP >= 5.4，并配置以下扩展
- cURL
USPS API 用户名

作者

Vincent Gabriel http://vadimg.com（原始 PHP 包装器）

mpinchuk / laravel-usps

维护者

详细信息