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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/lwwcaslaravel-countries.svg)](https://yunodb.com/tools/lwwcaslaravel-countries?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/lwwcaslaravel-countries?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/lwwcaslaravel-countries.svg" alt="Featured on YunoDB" height="20"></a>