README

用于轻松访问 RajaOngkir API 的 PHP 库包。

功能

• 列出所有省份。
• 根据 ID 获取省份。
• 根据名称搜索省份。
• 列出所有城市/县。
• 根据省份 ID 列出城市/县。
• 根据 ID 获取城市/县。
• 根据名称搜索城市/县。
• 获取运费（运费/快递费）。

待办事项

• Basic 和 Pro 账户类型的功能。
• 模糊搜索（使用 Fuse）。

系统要求

• PHP 7.0（建议使用 PHP 7.1 或更高版本）。

安装

使用 Composer 安装此库。

$ composer require Dzaki236/rajaongkir:^1.1

您还可以在 composer.json 中添加依赖。

{
    "require": {
        "Dzaki236/rajaongkir": "^1.1"
    }
}

Laravel 集成

对于 Laravel 5.5 或更高版本的用户，由于自动发现功能，此包将自动可用。您可以直接进入下面的 Laravel 配置 部分。

对于 Laravel 5.5 以下版本的用户，此项目中的代码在 Laravel 5.5 以下版本中未经测试。 因此，如果此库不能正常工作，请理解。

配置

对于 PHP native 用户，在实例化 class Dzaki236\RajaOngkir\RajaOngkir 时，将 API 密钥作为参数声明。

$rajaOngkir = new RajaOngkir('isi_API_key_Anda_disini');

Laravel 配置

您只需将包含 API 密钥的 RAJAONGKIR_API_KEY 值设置为环境变量。

RAJAONGKIR_API_KEY=isi_API_key_Anda_disini

您还可以发布配置文件以进行更详细的配置。

$ php artisan vendor:publish --provider="Dzaki236\RajaOngkir\Providers\LaravelServiceProvider"

使用

省份

列出省份

要获取省份列表，请使用方法 provinsi()->all()。

// Native PHP
use Dzaki236\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->provinsi()->all();

// Laravel
use Dzaki236\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::provinsi()->all();

根据 ID 获取省份

要获取根据 ID 的省份，请使用方法 provinsi()->find(int|string $id)。

// Native PHP
use Dzaki236\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->provinsi()->find(11);

// Laravel
use Dzaki236\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::provinsi()->find(11);

根据名称搜索省份

要搜索根据名称的省份，请使用方法 provinsi()->search(string $searchTerm)->get()。

// Native PHP
use Dzaki236\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->provinsi()->search('ja')->get();

// Laravel
use Dzaki236\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::provinsi()->search('ja')->get();

城市/县

城市/县列表

要获取城市/县列表，请使用方法 kota()->all()。

// Native PHP
use Dzaki236\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->kota()->all();

// Laravel
use Dzaki236\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::kota()->all();

根据ID获取城市/县

要获取根据ID的城市/县，请使用方法 kota()->find(int|string $id)。

// Native PHP
use Dzaki236\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->kota()->find(80);

// Laravel
use Dzaki236\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::kota()->find(80);

根据省份ID的城市/县列表

要获取根据省份ID的城市/县，请使用方法 kota()->dariProvinsi(int|string $provinceId)->get()。

// Native PHP
use Dzaki236\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->kota()->dariProvinsi(11)->find(80);

// Laravel
use Dzaki236\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::kota()->dariProvinsi(11)->find(80);

根据名称搜索城市/县

要搜索城市/县，请使用方法 kota()->search(string $searchTerm)->get()。

// Native PHP
use Dzaki236\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->kota()->search('su')->get();

// Laravel
use Dzaki236\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::kota()->search('su')->get();

您也可以在调用方法 search() 之前调用方法 dariProvinsi() 来从特定省份搜索城市/县。

// Native PHP
use Dzaki236\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->kota()->dariProvinsi(11)->search('su')->get();

// Laravel
use Dzaki236\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::kota()->dariProvinsi(11)->search('su')->get();

运输费用搜索

要获取运输费用，请使用方法 ongkosKirim(array $payload)。

// Native PHP
use Dzaki236\RajaOngkir\RajaOngkir;

$rajaOngkir = new RajaOngkir($apiKey);
$daftarProvinsi = $rajaOngkir->ongkosKirim([
    'origin'        => 155,     // ID kota/kabupaten asal
    'destination'   => 80,      // ID kota/kabupaten tujuan
    'weight'        => 1300,    // berat barang dalam gram
    'courier'       => 'jne'    // kode kurir pengiriman: ['jne', 'tiki', 'pos'] untuk starter
]);

// Laravel
use Dzaki236\RajaOngkir\Facades\RajaOngkir;

$daftarProvinsi = RajaOngkir::ongkosKirim([
    'origin'        => 155,     // ID kota/kabupaten asal
    'destination'   => 80,      // ID kota/kabupaten tujuan
    'weight'        => 1300,    // berat barang dalam gram
    'courier'       => 'jne'    // kode kurir pengiriman: ['jne', 'tiki', 'pos'] untuk starter
]);

除了 ongkosKirim() 方法外，还有 ongkir() 和 biaya() 方法作为 ongkosKirim() 方法的别名。

测试

使用以下命令运行测试。

$ vendor/bin/phpunit

许可证

MIT许可证（MIT）。请阅读许可证文件以获取详细信息。