lvqingan/laravel-cn-region

There is no license information available for the latest version (dev-master) of this package.

Laravel中国省市区无数据库实现方案

dev-master 2019-05-05 02:36 UTC

Requires

• php: >=7.0
• illuminate/database: 5.*
• illuminate/events: 5.*
• illuminate/support: 5.*

Requires (Dev)

• phpunit/phpunit: *

Unknown License

README

中国行政区划省市区（无数据表实现方案）

思路：通过身份证前6位来处理省市区的级联关系

安装

1. 安装代码库

composer require lvqingan/laravel-cn-region:dev-master

1. 修改 database/migration 中的表结构，增加保存区域的字段（默认使用region）

$table->char('region', 6);
$table->index(['region']);

1. 在 Eloquent 的模型中添加 HasRegion trait

默认使用 region 作为字段名，如果数据表使用的是其他字段来保存区域值，则需要定义属性 $regionFieldName

   class User extends Model
   {
       use HasRegion;
   }

   class User extends Model
   {
       use HasRegion;

       protected $regionFieldName = 'shengshiqu';
   }

获取下拉列表数据

省份

$provinces = (new \Lvqingan\Region\Loader('province'))->load();

{
    "110000":"北京市",
    "820000":"澳门特别行政区"
}

城市

$cities = (new \Lvqingan\Region\Loader('city', '340000'))->load();

{
    "340100":"合肥市",
    "341800":"宣城市"
}

区县

$districts = (new \Lvqingan\Region\Loader('340100', '340100'))->load();

{
    "340103":"庐阳区",
    "340111":"包河区"
}

获取名称

实例化的模型对象可以调用下面的属性（假设区域值为340104）

属性名称	说明	返回值
province_code	省份编码	340000
city_code	城市编码	340100
district_code	区县编码	340104
province_name	省份名称	安徽省
city_name	城市名称	合肥市
district_name	区县名称	蜀山区
full_city_name	完整城市名称	安徽省合肥市
full_district_name	完整区县名称	安徽省合肥市蜀山区

数据查询

按区域编码直接查询区域等于该值的数据

    User::whereRegion('340104')->get()

按区域编码直接查询区域包含在该范围内的数据

    User::whereInRegion('340000')->get()