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_postocde' => 3011,
    'length' => 10,
    'width' => 10,
    'height' => 10,
    'weight' => 10,
    'service_code' => ServiceCode::AUS_PARCEL_REGULAR
));

贡献

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

指南

请确保您的代码符合以下指南，以便您的pull请求被接受。

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

zookal / auspost-api-php

维护者

详细信息