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/indonesia.php，然后复制以下代码（将 indonesia_ 替换为您想要的表前缀），

<?php

return [
	'table_prefix' => 'indonesia_',
];

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

$app->configure('indonesia');

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

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

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

对于Lumen，必须手动将迁移文件从目录 vendor/laravolt/indonesia/src/migrations 或 Migrations 复制过来

运行迁移

php artisan migrate

运行 Seeder 以填充区域数据

php artisan laravolt:indonesia:seed

使用方法

\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