README

此包已被废弃且不再维护。建议使用 umpirsky/country-list。

关于标准化代码的PHP库

ISO 3166-1

国家

Countries 类包含一个列表，其中包含（英文）国家名称，与它们的 ISO 3166-1 alpha-2 国家代码相连接。

您可以获取完整的国家列表，通过名称获取国家代码或通过代码获取国家名称。

Jasny\ISO\Countries::getList(); // List all countries
Jasny\ISO\Countries::getName("US"); // 'United States'
Jasny\ISO\Countries::getCode("United States"); // 'US'

支持搜索替代国家名称。例如

Jasny\ISO\Countries::getCode("United States"); // 'US'
Jasny\ISO\Countries::getCode("United States of America"); // 'US'
Jasny\ISO\Countries::getCode("USA"); // 'US'

国家行政区域

CountrySubdivisions 类包含一个列表，其中包含国家（例如州或省）名称，与它们的 ISO 3166-2 代码相连接。

您可以获取一个国家的行政区域列表，通过名称获取行政区域代码或通过代码获取行政区域名称。

Jasny\ISO\CountrySubdivisions::getList("US"); // List all US states
Jasny\ISO\CountrySubdivisions::getName("US", "NY"); // 'New York'
Jasny\ISO\CountrySubdivisions::getCode("US", "New York"); // 'NY'

支持通过替代行政区域名称进行搜索。

您还可以检查一个国家是否需要完整的地址中的行政区域。这是澳大利亚、加拿大、中国、黑山、马来西亚和美国的情况。

Jasny\ISO\CountrySubdivisions::getRequired(); // ['AU', 'CA', 'CN', 'ME', 'MY', 'US']
Jasny\ISO\CountrySubdivisions::isRequired("US"); // true
Jasny\ISO\CountrySubdivisions::isRequired("NL"); // false

CSS 颜色模块级别 4

颜色

Colors 类允许在包括颜色名称在内的不同颜色语法之间进行转换。颜色语法由 W3C 标准 CSS 颜色模块级别 4 定义。

Jasny\ISO\Colors::getHex('blue'); // '#0000ff'
Jasny\ISO\Colors::getHex([0, 0, 255]); // '#0000ff'
Jasny\ISO\Colors::getRgb('blue'); // [0, 0, 255]
Jasny\ISO\Colors::getRgb('#0000ff'); // [0, 0, 255]
Jasny\ISO\Colors::getName('#0000ff'); // 'blue'
Jasny\ISO\Colors::getName([0, 0, 255]); // 'blue'

目前不支持从 HSL 转换到其他格式或从其他格式转换到 HSL。