[擴充套件]一個基於laravel的省市縣三級資料生成器laravel-region

南城以南發表於2020-12-29

開發初衷

每次開發新的專案 都需要加定位/地區選擇等功能 18年自己寫了一個功能,但是之後每次需要的時候都需要自己重新寫。為此自己寫了這款擴充套件包。

基於高德開放平臺 的省市區三級聯動資料生成器。

安裝

$ composer require lysice/laravel-region -vvv

配置

在使用本擴充套件之前,你需要去 高德開放平臺 註冊賬號,然後建立應用,獲取應用的 API Key。

使用

1.釋出配置檔案與遷移

 php artisan vendor:publish --provider=Lysice\Region\RegionServiceProvider

2.配置項

config檔案裡生成的region.php中的配置項一共有四個分別是

  • table 標識要生成遷移的表名
  • connection 標識要使用的資料庫連線配置名,對應database.php中的connections選項中的配置 如設定成mysql 則會使用 config(‘database.connections.mysql’)的配置。
  • key 高德開放平臺建立應用的key
  • prefix 標識要生成的表名字首

3.生成遷移表

 php artisan migrate

4.生成資料 可以使用三種方式

4.1方法引數注入Region例項生成

 public function region(Region $region){
     $response = $region->region(); 
 }

4.2服務名訪問例項方法

 public function edit() {
     $response = app('region')->region(); 
 }

命令列執行

 php artisan region:generate

之後在資料庫你生成的表結構

參考

高德開放平臺介面

License

MIT

後續功能 持續完善 有好的建議也可以留個言~

  • 新增省市區的trait 可以直接在model裡使用 不需要自己再寫方法
  • 新增經緯度(可選)
  • 新增鄉鎮(可選)
本作品採用《CC 協議》,轉載必須註明作者和本文連結

相關文章