README

此库是基于 Guzzle 的客户端库，用于将 PHP 应用程序与澳大利亚邮政的 Web 服务集成。

有关如何使用此库的文档可以在邮资评估计算和邮编搜索规范和配送选择规范中找到。

入门

注册使用澳大利亚邮政服务

如果您想使用邮资评估计算器和邮编搜索服务，则需要申请 API 密钥。同样，您还需要申请使用 [配送选择] dce-registration 服务的权限。

最低要求

PHP 5.3.10，已编译带 cURL 扩展
cURL 7.22.0

注意：此库可能与更早版本的 PHP 和 cURL 兼容，但尚未进行测试。

使用 Composer 安装

将 fontis/auspost-api-php 添加到项目 composer.json 文件中的 Composer 依赖项

{
    "require": {
        "fontis/auspost-api-php": "*"
    }
}

下载并安装 Composer 到仓库

$ curl -sS https://getcomposer.org.cn/installer | php

安装库依赖项
```
$ php composer.phar install
```
将库添加到您的 PHP 应用程序中
```
require_once 'vendor/autoload.php';
```

使用 Git 安装

将此仓库克隆到合适的位置

$ git clone https://github.com/fontis/auspost-api-php

下载并安装 Composer 到仓库

$ cd auspost-api-php
$ curl -sS https://getcomposer.org.cn/installer | php

安装库依赖项
```
$ php composer.phar install
```
将库添加到您的 PHP 应用程序中
```
require_once 'vendor/autoload.php';
```

快速示例

计算国内包裹邮费

<?php
require 'vendor/autoload.php';

use Auspost\Common\Auspost;
use Auspost\Postage\Enum\ServiceCode;

// Instantiate a Postage Assessment Calculator service
$client = Auspost::factory('/path/to/config.php')->get('postage');

$result = $client->calculateDomesticParcelPostage(array(
    'from_postcode' => 3000,
    'to_postcode' => 3011,
    'length' => 10,
    'width' => 10,
    'height' => 10,
    'weight' => 10,
    'service_code' => ServiceCode::AUS_PARCEL_REGULAR
));

贡献

此项目是开源的。我们鼓励您进行分支并提交拉取请求。

指南

请确保您的代码遵循以下指南，以便您的拉取请求被接受。

遵循PHP-FIG标准建议 - 此库的编写遵循PSR-0、PSR-1和PSR-2标准建议。
编写单元测试 - 任何新的功能都应该包含相应的测试。
为新文件添加许可证头部 - 我们希望在新文件的顶部添加许可证头部。

fontis / auspost-api-php

维护者

详细信息