bronanza / laravel-ongkir

此包提供使用 raja ongkir API 的功能

dev-master 2017-01-15 14:45 UTC

This package is not auto-updated.

Last update: 2024-09-20 17:32:43 UTC


README

Laravel ongkir 提供在 Laravel 5 中使用 raja ongkir API 的功能。

内容

安装

  1. 要安装 laravel-ongkir,请将以下代码添加到 composer.json 中。然后运行 composer update
"bronanza/laravel-ongkir": "dev-master"
  1. 打开您的 config/app.php 并在 provider 中添加以下代码
Bronanza\LaravelOngkir\OngkirServiceProvider::class,
  1. 运行以下命令以发布包配置文件 config/ongkir.php
php artisan vendor:publish
  1. 您可以在 config/ongkir.php 中填写 Laravel ongkir 的 api key
<?php

return [
    'api' => 'http://api.rajaongkir.com/starter',
    'apiKey' => '12kasjdaksdqpwepqwoepqwoe',
    'originCityId' => 151, // Jakarta Barat Based on RajaOngkir API
    'couriers' => [
        'jne'  => 'JNE',
        'tiki' => 'TIKI'
    ]
];

使用

  1. 在您的类文件中添加以下代码
use Bronanza\LaravelOngkir\Ongkir;
  1. 现在您可以使用 Laravel-Ongkir
<?php
namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use Bronanza\LaravelOngkir\Ongkir;

class TestController extends Controller
{
    private $laravelOngkir;

    public function __construct(Ongkir $ongkir)
    {
        $this->laravelOngkir = $ongkir;
    }

    public function getAllAvailableProvinces()
    {
        return $this->laravelOngkir->getAllAvailableProvinces();
    }

    public function getAllAvailableCities()
    {
        return $this->laravelOngkir->getAllAvailableCities();
    }

    public function getAvailableCities()
    {
        return $this->laravelOngkir->getAvailableCities("5");
    }

    public function getCosts()
    {
        return $this->laravelOngkir->getCosts("501", "114", 1700, "jne");
    }
}

说明

  1. getAllAvailableProvinces() - 使用此方法获取印度尼西亚所有可用的省份。
  2. getAllAvailableCities() - 使用此方法获取印度尼西亚所有可用的城市。
  3. getAvailableCities() - 使用此方法获取给定省份代码的可用的城市。此方法需要 1 个参数
    • string provinceCode - 印度尼西亚省份 ID
  4. getCosts() - 使用此方法根据重量和位置获取运费。此方法需要 4 个参数
    • string originId - 城市来源
    • string rajaongkirCityId - 目的城市
    • int weight - 运输重量(克)
    • string courier - 可用的快递代码:jnepostiki