mutahir-shah/uspslaravel

此版本是 https://github.com/johnpaulmedina/laravel-usps 的修改版本

dev-master 2018-02-07 05:45 UTC

This package is auto-updated.

Last update: 2024-09-05 14:38:06 UTC


README

以下包的更新版本。更新由 mutahir@pkteam.com 完成。Laravel-USPS 更新了 https://github.com/johnpaulmedina/laravel-usps 包。

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

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

安装

通过 Composer 安装此包。在终端中运行此命令

composer require mutahir-shah/uspslaravel: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,getPriorityLabels,calculateRates,它定义在 vendor/johnpaulmedina/laravel-usps/src/Usps/Usps.php 中。我正在添加更多方法。我建议查看 @VinceG 的原始 PHP-Wrapper 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() {
          $response =  response()->json(
            Usps::getPriorityLabels(['Apartment'=>'','Address'=>'10113 Condor Loop','Zip'=>'76708','City'=>'Waco','State'=>'TX']));
    }
}

@VinceG 原始 README.MD

USPS PHP API

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

  • 运费计算器(国内和国际)
  • 通过地址查找邮编
  • 通过邮编查找城市/州
  • 验证地址
  • 创建优先快递标签
  • 创建开放并分发快递标签
  • 创建国际快递标签(快递、优先、一等)
  • 服务送货计算器
  • 确认跟踪

要求

  • PHP >= 5.4 配置了以下扩展
    • cURL
  • USPS API 用户名

作者

由 Mutahir Shah http://pkteam.com 进行了进一步的修改和增强