laravel-countries
Laravel 國家資料庫套件,包含 Eloquent 模型、ISO 3166 代碼、國旗、GeoJSON 地圖、電話代碼、貨幣及 9 種語言翻譯。
laravel-countries 是什麼?
Laravel 國家資料庫套件,包含 Eloquent 模型、ISO 3166 代碼、國旗、GeoJSON 地圖、電話代碼、貨幣及 9 種語言翻譯。內建適用於 Laravel 10–13 的遷移與種子資料。
laravel-countries 概覽
這是什麼
Laravel Countries 是一個以 Eloquent 為核心的 Laravel 套件,提供完整的國家資料庫。它將國家資料建模為原生的 Eloquent 模型,包含 ISO 3166 代碼、國際電話區號、貨幣、國旗(SVG、表情符號、HEX/RGB 顏色)、GeoJSON 邊界、地理座標、人口統計、GDP、獨立日期以及區域階層。所有資料都會被植入你自己的資料庫,並翻譯成 9 種語言。不需要任何外部 API。
主要功能
- 原生 Eloquent 國家模型,支援範圍查詢、關聯與預載入
- ISO 3166 代碼(Alpha-2、Alpha-3、數字),可透過
whereIso、whereIsoAlpha3、whereIsoNumeric查詢 - 國際電話區號與貨幣資料
- 三種格式的國旗:SVG 標記、表情符號、HEX/RGB 顏色
- 用於地圖繪製的 GeoJSON 邊界與座標
- 內建 9 種語言翻譯:阿拉伯語、荷蘭語、英語、德語、義大利語、葡萄牙語、俄語、西班牙語、土耳其語
- 單一 Artisan 指令即可安裝並植入所有資料,具冪等性且適合 CI 環境
使用情境
- 提供在地化名稱的國家選擇下拉選單
- 使用 GeoJSON 邊界進行地理地圖繪製
- 依國家代碼驗證電話號碼
- 貨幣顯示與轉換參考
- 國際化應用程式的多語言國家與地區名稱
- 分析或報表中的人口統計與經濟資料
快速開始
composer require lwwcas/laravel-countries
php artisan w-countries:install
在正式環境或 CI 環境中,請加上 --force 參數:
php artisan w-countries:install --force
若只需植入特定語言:
php artisan w-countries:seed --languages=en,pt
授權與價格
本套件為開放原始碼,採用 MIT 授權條款,可免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。