jasester/laravel-china-address

中国省份、城市、区县、街道四级联动数据

dev-main 2022-08-02 01:01 UTC

MIT

• jasester

README

说明

1. 一个关于 Laravel 的 中国行政区: 省份 城市 区县 乡镇 四级联动数据表生成,数据来源于权威机构:民政部和国家统计局. 民政部、国家统计局： 中华人民共和国民政部-中华人民共和国行政区划代码 中华人民共和国国家统计局-统计用区划和城乡划分代码 中华人民共和国国家统计局-统计用区划代码和城乡划分代码编制规则

使用

发布migration文件 并填充数据

composer require jasester/laravel-china-address

php artisan vendor:publish --provider="Jasester\LaravelChinaAddress\ChinaAddressServiceProvider"

php artisan migrate

php artisan address:import

创建Address model

php artisan make:model Address -c

Address model 中 使用 AddressTrait

namespace App;

use Illuminate\Database\Eloquent\Model;
use Jasester\LaravelChinaAddress\AddressTrait;

class Address extends Model
{
    use AddressTrait;

    public $timestamps = false;

    protected $primaryKey = 'code';

    protected $fillable = ['code', 'name', 'parent_code'];

    public function getRouteKeyName()
    {
        return 'code';
    }
    
}

trait 方法

parent() 父级地址

children() 子地址

getFullPath($joiner) 获取完整的地址字符串,$joiner可选参数,地址字符串的拼接符,默认为' '

allChildren() 获取所有的用户,包含各级的children