README

越南地区数据库。

数据直接来自越南国家统计局。

安装

composer require hoangphi/vietnam-maps

提取

方法 1

通过命令直接提取

php artisan vietnam-map:install

方法 2

复制配置和迁移文件

php artisan vendor:publish --provider="HoangPhi\VietnamMap\VietnamMapServiceProvider"

自定义配置和迁移

重命名表

打开文件 config/vietnam-maps.php 和配置

'tables' => [
    'provinces' => 'provinces',
    'districts' => 'districts',
    'wards'     => 'wards',
],

重命名列

打开文件 config/vietnam-maps.php 和配置

'columns' => [
    'name'        => 'name',
    'gso_id'      => 'gso_id',
    'province_id' => 'province_id',
    'district_id' => 'district_id',
],

添加列

打开以下迁移文件，如有需要则进行自定义

database/migrations/{datetime}_create_vietnam_maps_table.php

运行迁移

php artisan migrate

下载并导入数据库

php artisan vietnam-map:download

使用模型进行使用

获取所有省份、区、街道

    use HoangPhi\VietnamMap\Models\Province;
    use HoangPhi\VietnamMap\Models\District;
    use HoangPhi\VietnamMap\Models\Ward;

   class DevController extends Controller
   {
       ...
       public function dev()
       {
           $provinces = Province::all();
           $districts = District::all();
           $wards = Ward::all();
           ...
       }
   }

使用关系获取数据

    use HoangPhi\VietnamMap\Models\Province;

   class DevController extends Controller
   {
       ...
       public function dev()
       {
           $province = Province::first();
           $districts = $province->districts;
           ...
       }
   }

Province.php 中的关系

    class Province extends Model
    {
        ...
        public function districts()
        {
            return $this->hasMany(District::class);
        }
    }

District.php 中的关系

    class District extends Model
    {
        ...
        public function province()
        {
            return $this->belongsTo(Province::class, config('vietnam-maps.columns.province_id'), 'id');
        }
        
        public function wards()
        {
            return $this->hasMany(Ward::class);
        }
    }

Ward.php 中的关系

    class Ward extends Model
    {
        ...
        public function district()
        {
            return $this->belongsTo(District::class, config('vietnam-maps.columns.district_id'), 'id');
        }
    }

变更日志

有关最近更改的更多信息，请参阅 CHANGELOG。

安全性

如果您发现任何与安全性相关的问题，请通过电子邮件 hoangphidev@gmail.com 反馈，而不是使用问题跟踪器。

致谢

参考资料

许可证

Laravel 框架是开源软件，受 MIT 许可许可。

nguyenquang2302 / vietnam-maps-clone

维护者

详细信息