README

LARAVOLT INDONESIA

包含印度尼西亚所有省份、县/市和区和村庄/乡村数据的 Laravel 包。数据来自 edwardsamuel/Wilayah-Administratif-Indonesia

安装

通过 Composer 安装包

composer require laravolt/indonesia

注册 Service Provider 和 Facade (对于 Laravel < 5.5)

从 5.5 版本开始，Laravel 已经支持自动发现功能，因此无需手动注册 Service Provider 和 Facade。

在 config.app 中添加 Service Provider 和 Facade

'providers' => [

    Laravolt\Indonesia\ServiceProvider::class

]

'aliases' => [

    'Indonesia' => Laravolt\Indonesia\Facade::class

]

为 Lumen 注册 Service Provider 和 Facade

在文件 bootstrap/app.php 中取消以下行的注释

$app->withFacades();
$app->withEloquent();

在文件 bootstrap/app.php 中，通过添加以下代码来注册 service provider 和 alias/facade。

$app->register(Laravolt\Indonesia\ServiceProvider::class);


// class aliases
class_alias(Laravolt\Indonesia\Facade::class, 'Indonesia');

要设置表前缀，创建文件 config/laravolt.php，然后复制以下代码（将 indonesia_ 替换为您想要的表前缀值），

<?php

return [
    'indonesia' => [
        'table_prefix' => 'id_',
    ],
];

然后通过添加以下代码在 bootstrap/app.php 中注册配置。

$app->configure('laravolt');

之后，可以通过 config('laravolt.indonesia.table_prefix') 来调用配置。

发布迁移（仅适用于 Laravel/Lumen 5.2）

如果您使用的是 Laravel/Lumen 5.3 或更高版本，请忽略以下步骤。对于 Laravel

php artisan vendor:publish --provider="Laravolt\Indonesia\ServiceProvider"

对于 Lumen，需要手动将迁移文件从 vendor/laravolt/indonesia/database/migrations 目录或 Migrations 复制到相应的位置。

运行迁移

php artisan migrate

运行 Seeder 以填充区域数据

php artisan laravolt:indonesia:seed

要将 Seeder 添加到文件 DatabaseSeeder.php 中，请按照以下示例操作

namespace Database\Seeders;

use Illuminate\Database\Seeder;
use Laravolt\Indonesia\Seeds\CitiesSeeder;
use Laravolt\Indonesia\Seeds\VillagesSeeder;
use Laravolt\Indonesia\Seeds\DistrictsSeeder;
use Laravolt\Indonesia\Seeds\ProvincesSeeder;

class DatabaseSeeder extends Seeder
{
    /**
     * Seed the application's database.
     *
     * @return void
     */
    public function run()
    {
        $this->call([
            ProvincesSeeder::class,
            CitiesSeeder::class,
            DistrictsSeeder::class,
            VillagesSeeder::class,
        ]);
    }
}

用法

\Indonesia::allProvinces()
\Indonesia::paginateProvinces($numRows = 15)
\Indonesia::allCities()
\Indonesia::paginateCities($numRows = 15)
\Indonesia::allDistricts()
\Indonesia::paginateDistricts($numRows = 15)
\Indonesia::allVillages()
\Indonesia::paginateVillages($numRows = 15)

\Indonesia::findProvince($provinceId, $with = null)
// array $with : ['cities', 'districts', 'villages', 'cities.districts', 'cities.districts.villages', 'districts.villages']

\Indonesia::findCity($cityId, $with = null)
// array $with : ['province', 'districts', 'villages', 'districts.villages']

Indonesia::findDistrict($districtId, $with = null)
// array $with : ['province', 'city', 'city.province', 'villages']

\Indonesia::findVillage($villageId, $with = null)
// array $with : ['province', 'city', 'district', 'district.city', 'district.city.province']

示例

Indonesia::findProvince(11, ['cities']);

/*
Will return
Province Object {
    'id' => 11,
    'name' => 'ACEH',
    'cities' => City Collections {
        City Object,
        City Object,
        City Object,
        ...
    }
}
*/

Indonesia::findProvince(11, ['cities', 'districts.villages']);

/*
Will return
Province Object {
    'id' => 11,
    'name' => 'ACEH',
    'cities' => City Collections {
        City Object,
        City Object,
        City Object,
        ...
    },
    'districts' => District Collections {
        District Object {
            'id' => 1101010
            'city_id' => '1101'
            'name' => 'TEUPAH SELATAN'
            'province_id' => '11'
            'villages' => Village Colletions {
                Village Object,
                Village Object,
                Village Object,
                ...
            }
        },
        ...
    }
}
*/

\Indonesia::search('jakarta')->all()
\Indonesia::search('jakarta')->allProvinces()
\Indonesia::search('jakarta')->paginateProvinces()
\Indonesia::search('jakarta')->allCities()
\Indonesia::search('jakarta')->paginateCities()
\Indonesia::search('jakarta')->allDistricts()
\Indonesia::search('jakarta')->paginateDistricts()
\Indonesia::search('jakarta')->allVillages()
\Indonesia::search('jakarta')->paginateVillages()

测试

运行

vendor/bin/phpunit tests