README

这是一个简单的 PHP 包，提供了所有国家的信息，包括 ISO 代码、名称和国旗。

数据来源

本包使用的国家数据来自 ISO 3166-1 标准，包括：

ISO 3166-1 alpha-2 代码（如：CN）
ISO 3166-1 alpha-3 代码（如：CHN）
ISO 3166-1 numeric 代码（如：156）
国家英文名称

安装

使用 Composer 安装：

composer require happyphper/country

使用方法

获取所有国家

use HappyPhper\Country\CountryCollection;

$collection = new CountryCollection();
$countries = $collection->getAll();

通过 ISO 代码获取国家

use HappyPhper\Country\CountryCollection;

$collection = new CountryCollection();

// 通过 ISO 3166-1 alpha-2 代码获取
$country = $collection->getByAlpha2('CN');

// 通过 ISO 3166-1 alpha-3 代码获取
$country = $collection->getByAlpha3('CHN');

// 通过 ISO 3166-1 numeric 代码获取
$country = $collection->getByNumeric('156');

获取国家信息

$country = $collection->getByAlpha2('CN');

echo $country->getName();        // 输出: China
echo $country->getAlpha2();      // 输出: CN
echo $country->getAlpha3();      // 输出: CHN
echo $country->getNumeric();     // 输出: 156
echo $country->getFlagUrl();     // 输出: https://flagcdn.com/w320/cn.png

获取国旗 URL

包支持多种方式获取国旗 URL：

1. 获取默认尺寸的国旗（320px 宽度）

$country = $collection->getByAlpha2('CN');
echo $country->getFlagUrl();     // 输出: https://flagcdn.com/w320/cn.png

2. 获取固定宽度的国旗

// 支持的宽度：20, 40, 80, 160, 320, 640, 1280, 2560
echo $country->getFlagUrlByWidth(640);  // 输出: https://flagcdn.com/w640/cn.png

3. 获取固定高度的国旗

// 支持的高度：20, 24, 40, 60, 80, 120, 240
echo $country->getFlagUrlByHeight(240);  // 输出: https://flagcdn.com/h240/cn.png

4. 获取固定尺寸的国旗

// 支持任意宽度和高度
echo $country->getFlagUrlByDimensions(16, 12);  // 输出: https://flagcdn.com/16x12/cn.png

5. 获取不同格式的国旗

// 支持的格式：png, webp, svg, jpg
echo $country->getFlagUrlByWidth(320, Country::FORMAT_WEBP);  // 输出: https://flagcdn.com/w320/cn.webp
echo $country->getFlagUrlByWidth(320, Country::FORMAT_SVG);   // 输出: https://flagcdn.com/w320/cn.svg
echo $country->getFlagUrlByWidth(320, Country::FORMAT_JPEG);  // 输出: https://flagcdn.com/w320/cn.jpg

6. 获取 SVG 格式的国旗

echo $country->getSvgFlagUrl();  // 输出: https://flagcdn.com/cn.svg

多语言支持

本包支持多语言（国际化），可通过设置 locale 获取不同语言的国家名称。目前已内置支持：英文（en）、简体中文（zh-CN）、繁体中文（zh-TW）。

示例

use HappyPhper\Country\CountryCollection;

// 创建中文集合
$collection = new CountryCollection('zh-CN');
$china = $collection->getByAlpha2('CN');
echo $china->getLocalizedName(); // 输出: 中国

// 切换为繁体中文
$collection->setLocale('zh-TW');
echo $china->getLocalizedName(); // 输出: 中國

// 切换为英文
$collection->setLocale('en');
echo $china->getLocalizedName(); // 输出: China

如需自定义语言，可在 resources/lang/ 目录下添加对应的语言文件。

国旗来源

国旗图片来自 flagcdn.com，这是一个免费的国旗 CDN 服务。

许可证

MIT License

happyphper / country

Maintainers

Details