README

简化与世界各地的地点和数据交互

例如，获取美国州、加拿大省列表，以及验证邮编或电话号码是否有效应该很容易。一些国家根本不使用邮编，不同国家的电话号码有不同的标准。这个库旨在使事情变得更简单。

对于每个国家对象，您可以访问以下信息

• 通用名称
• 官方名称
• ISO 3166-1 alpha 2代码（例如，US代表美国）
• ISO 3166-2 alpha 3代码（例如，USA代表美国）
• ISO 4127货币代码（例如，USD代表美国美元）
• 大陆

可用的接口包括

• PhoneNumberInterface - 提供电话号码验证方法签名
• PostalCodeInterface - 提供邮编验证方法签名
• SubdivisionInterface - 提供子区域列表，例如加拿大省

可用的特质包括

• NorthAmericanPhoneNumber
• ZipCode

版本

当前版本是0.2.0。此项目使用语义版本控制。

许可证

此代码基于MIT许可证。

示例代码

检索单个国家

require 'vendor/autoload.php';

$usa = Awoods\World\CountryFactory::get('US');
echo $usa->getOfficialName(); // Unites States of America

$canada = Awoods\World\CountryFactory::get('CAN');
echo $canada->getCommonName(); // Canada

遍历所有国家

require "vendor/autoload.php";

$countryFactory = new \Awoods\World\CountryFactory();
$countries = $countryFactory->getAllCountries();

foreach ($countries AS $code => $name) {
    echo "\n";
    echo "{$code} is the code for {$name}\n";

    $country = $countryFactory->create($code);

    echo "The official name for {$name} is '{$country->getFullName()}'\n";
    echo "Here is a list of it's localities:\n";

    foreach ($country->getLocalityList() AS $localityCode => $localityName) {
        echo "* {$localityName} ({$localityCode})\n";
    }
}
echo "\n";

当前支持的国家

北美洲

这些国家有额外的电话号码和邮编验证方法

• 美国
• 加拿大
• 墨西哥

这些国家有基本的Country支持

• 安圭拉
• 安提瓜和巴布达
• 阿鲁巴
• 巴哈马
• 巴巴多斯
• 伯利兹
• 百慕大
• 英属维尔京群岛
• 加勒比荷兰
• 开曼群岛
• 哥斯达黎加
• 古巴
• 库拉索
• 多米尼克
• 多米尼加共和国
• 萨尔瓦多
• 格陵兰
• 格林纳达
• 瓜德罗普
• 危地马拉
• 海地
• 洪都拉斯
• 牙买加
• 马提尼克
• 蒙特塞拉特
• 尼加拉瓜
• 巴拿马
• 波多黎各
• 圣马丁
• 圣巴泰勒米岛
• 圣基茨和尼维斯
• 圣卢西亚
• 圣马丁岛
• 圣皮埃尔和密克隆
• 圣文森特和格林纳丁斯
• 特立尼达和多巴哥
• 特克斯和凯科斯群岛
• 美属维尔京群岛

即将到来的国家

• 南美洲

  • 待办事项

• 欧洲

  • 待办事项

• 亚洲

  • 待办事项

• 非洲

  • 待办事项

• 大洋洲

  • 待办事项

• 南极洲

  • 待办事项

章节/页面的想法

• 特质

  • NorthAmericanPhoneNumber

• 功能

• 语言翻译

  这5种语言加上英语应该涵盖世界上大多数开发者

  • 西班牙语
  • 法语
  • 印地语
  • 中文（普通话）
  • 阿拉伯语

• 常见问题解答（FAQ）

• 屏幕截图

• 提交问题

致谢和认可

• 项目创建者：Andrew Woods