sierratecnologia/countries

SierraTecnologia Countries 是一个简单且轻量级的包，用于灵活检索国家详情。它包含了250个国家的各种数据，包括名称、俗称、首都、ISO代码、区号、地理数据、货币、国旗、表情符号以及其他属性，所有这些数据都可在您的指尖轻松获取。

维护者

详细信息

github.com/SierraTecnologia/countries

主页

源代码

问题

文档

资助包维护！
ricasolucoes
ricasolucoes.com.br/open-source/support-us

安装: 52

依赖者: 1

建议者: 0

安全: 0

星标: 0

关注者: 1

分支: 206

v6.1.2 2019-12-13 08:34 UTC

Requires

  • php: ^7.2.0

Requires (Dev)

MIT 1c6c73cd1713b67ee6b50996b3693a618219fa48

FlexibleSimpleflagsemojicountriescountrysvglanguagescurrenciesgeographicdiallingdemonymSierraTecnologia

This package is auto-updated.

Last update: 2024-09-16 05:02:20 UTC

README

SierraTecnologia Country 是一个简单且轻量级的包，用于灵活检索国家详情。它包含了250个国家的各种数据，包括名称、俗称、首都、ISO代码、区号、地理数据、货币、国旗、表情符号以及其他属性，所有这些数据都可在您的指尖轻松获取。

Packagist Scrutinizer Code Quality Travis StyleCI License

用法

通过composer require sierratecnologia/countries安装，然后直观使用

// Get single country
$egypt = country('eg');

// Get country name                                 // Get country native name
echo $egypt->getName();                             echo $egypt->getNativeName();

// Get country official name                        // Get country ISO 3166-1 alpha2 code
echo $egypt->getOfficialName();                     echo $egypt->getIsoAlpha2();

// Get country area                                 // Get country borders
echo $egypt->getArea();                             echo $egypt->getBorders();

// Get country currencies                           // Get country languages
echo $egypt->getCurrencies();                       echo $egypt->getLanguages();

// Get country emoji                                // Get country flag
echo $egypt->getEmoji();                            echo $egypt->getFlag();


// Get all countries                                // Get countries with where condition (continent: Oceania)
$countries = countries();                           $whereCountries = \Country\CountryLoader::where('geo.continent', ['OC' => 'Oceania']);

注意：此包与任何PHP框架无关，因此无需任何依赖即可与任何PHP框架兼容，除了PHP版本本身 ^7.0。棒极了，不是吗？ 😃

目录

高级用法

获取国家属性（自解释的）

$egypt = country('eg');

// Egypt                                            // مصر
$egypt->getName();                                  $egypt->getNativeName();

// Arab Republic of Egypt                           // جمهورية مصر العربية
$egypt->getOfficialName();                          $egypt->getNativeOfficialName();

// Egyptian                                         // Cairo
$egypt->getDemonym();                               $egypt->getCapital();

// EG                                               // EGY
$egypt->getIsoAlpha2();                             $egypt->getIsoAlpha3();

// 818                                              // .eg
$egypt->getIsoNumeric();                            $egypt->getTld();

// [".eg",".مصر"]                                   // ["EG","Arab Republic of Egypt"]
$egypt->getTlds();                                  $egypt->getAltSpellings();

// Arabic                                           // {"ara":"Arabic"}
$egypt->getLanguage();                              $egypt->getLanguages();

// Africa                                           // true
$egypt->getContinent();                             $egypt->usesPostalCode();

// 27 00 N                                          // 30 00 E
$egypt->getLatitude();                              $egypt->getLongitude();

// 26.756103515625                                  // 29.86229705810547
$egypt->getLatitudeDesc();                          $egypt->getLongitudeDesc();

// 31.916667                                        // 36.333333
$egypt->getMaxLatitude();                           $egypt->getMaxLongitude();

// 20.383333                                        // 24.7
$egypt->getMinLatitude();                           $egypt->getMinLongitude();

// 1002450                                          // Africa
$egypt->getArea();                                  $egypt->getRegion();

// Northern Africa                                  // EMEA
$egypt->getSubregion();                             $egypt->getWorldRegion();

// 002                                              // 015
$egypt->getRegionCode();                            $egypt->getSubregionCode();

// false                                            // ["ISR","LBY","SDN"]
$egypt->isLandlocked();                             $egypt->getBorders();

// Yes                                              // 20
$egypt->isIndependent();                            $egypt->getCallingCode();

// ["20"]                                           // 0
$egypt->getCallingCodes();                          $egypt->getNationalPrefix();

// 9                                                // [9]
$egypt->getNationalNumberLength();                  $egypt->getNationalNumberLengths();

// 2                                                // [2]
$egypt->getNationalDestinationCodeLength();         $egypt->getnationaldestinationcodelengths();

// "00"                                             // {{recipient}}\n{{street}}\n{{postalcode}} {{city}}\n{{country}}
$egypt->getInternationalPrefix();                   $egypt->getAddressFormat();

// 357994                                           // H2
$egypt->getGeonameid();                             $egypt->getEdgar();

// EGY                                              // ua
$egypt->getItu();                                   $egypt->getMarc();

// EG                                               // ET
$egypt->getWmo();                                   $egypt->getDs();

// EGY                                              // EG
$egypt->getFifa();                                  $egypt->getFips();

// 40765                                            // EGY
$egypt->getGaul();                                  $egypt->getIoc();

// EGY                                              // 651
$egypt->getCowc();                                  $egypt->getCown();

// 59                                               // 469
$egypt->getFao();                                   $egypt->getImf();

// MAF                                              // null
$egypt->getAr5();                                   $egypt->isEuMember();

// null                                             // 🇪🇬
$egypt->getVatRates();                              $egypt->getEmoji();

// GeoJson data returned as string                  // SVG data returned as string
$egypt->getGeoJson();                               $egypt->getFlag();

// Divisions returned as array                      // {"official":"جمهورية مصر العربية","common":"مصر"}
$egypt->getDivisions();                             $egypt->getTranslation();

// {"ara":{"official":"جمهورية مصر العربية","common":"مصر"}}
$egypt->getNativeNames();

// {"iso_4217_code":"EGP","iso_4217_numeric":818,"iso_4217_name":"Egyptian Pound","iso_4217_minor_unit":2}
$egypt->getCurrency();

// {"EGP":{"iso_4217_code":"EGP","iso_4217_numeric":818,"iso_4217_name":"Egyptian Pound","iso_4217_minor_unit":2}}
$egypt->getCurrencies();

// {"ara":{"official":"جمهورية مصر العربية","common":"مصر"},"cym":{"official":"Arab Republic of Egypt","common":"Yr Aifft"},"deu":{"official":"Arabische Republik Ägypten","common":"Ägypten"},"fra":{"official":"République arabe d'Égypte","common":"Égypte"},"hrv":{"official":"Arapska Republika Egipat","common":"Egipat"},"ita":{"official":"Repubblica araba d'Egitto","common":"Egitto"},"jpn":{"official":"エジプト·アラブ共和国","common":"エジプト"},"nld":{"official":"Arabische Republiek Egypte","common":"Egypte"},"por":{"official":"República Árabe do Egipto","common":"Egito"},"rus":{"official":"Арабская Республика Египет","common":"Египет"},"spa":{"official":"República Árabe de Egipto","common":"Egipto"},"fin":{"official":"Egyptin arabitasavalta","common":"Egypti"}}
$egypt->getTranslations();

// {"continent":{"AF":"Africa"},"postal_code":true,"latitude":"27 00 N","latitude_dec":"26.756103515625","longitude":"30 00 E","longitude_dec":"29.86229705810547","max_latitude":"31.916667","max_longitude":"36.333333","min_latitude":"20.383333","min_longitude":"24.7","area":1002450,"region":"Africa","subregion":"Northern Africa","world_region":"EMEA","region_code":"002","subregion_code":"015","landlocked":false,"borders":["ISR","LBY","SDN"],"independent":"Yes"}
$egypt->getGeodata();

// {"geonameid":357994,"edgar":"H2","itu":"EGY","marc":"ua","wmo":"EG","ds":"ET","fifa":"EGY","fips":"EG","gaul":40765,"ioc":"EGY","cowc":"EGY","cown":651,"fao":59,"imf":469,"ar5":"MAF","address_format":"{{recipient}}\n{{street}}\n{{postalcode}} {{city}}\n{{country}}","eu_member":null,"vat_rates":null,"emoji":"🇪🇬"}
$egypt->getExtra();

// {"name":"Al Iskandariyah","alt_names":["El Iskandariya","al-Iskandariyah","al-Iskandarīyah","Alexandria","Alexandrie","Alexandria"],"geo":{"latitude":31.2000924,"longitude":29.9187387,"min_latitude":31.1173177,"min_longitude":29.8233701,"max_latitude":31.330904,"max_longitude":30.0864016}}
$egypt->getDivision("ALX");

注意：在检索单个国家时，您将获得与上一个示例中相同的完整国家详情。但在检索所有国家时，您将获得一个简短的国家详情列表，以提高性能。

功能说明

  • 国家数据存储在此：resources/data/countries.json。
  • name
    • common - 英文通用名称
    • official - 英文官方名称
    • native - 所有本地名称列表
      • 键：三个字母的ISO 639-3语言代码
      • 值：名称对象
        • 键：official - 官方名称翻译
        • 键：common - 通用名称翻译
  • demonym - 居民名称
  • capital - 首都城市
  • iso_3166_1_alpha2 - ISO 3166-1 alpha-2代码
  • iso_3166_1_alpha3 - ISO 3166-1 alpha-3代码
  • iso_3166_1_numeric - ISO 3166-1数字代码
  • currency - ISO 4217货币代码（s）
    • 键：三个字母的ISO 4217货币代码
    • 值：货币对象
      • 键：iso_4217_code - 三个字母的ISO 4217货币alpha代码
      • 键：iso_4217_numeric - 三位数字ISO 4217货币数字代码
      • 键：iso_4217_name - 官方ISO 4217货币名称
      • 键：iso_4217_minor_unit - 小货币单位
  • tld - 国家顶级域名
  • alt_spellings - 替代拼写
  • languages - 官方语言列表
    • 键：三个字母的ISO 639-3语言代码
    • 值：英文中的语言名称
  • translations - 名称翻译列表
    • 键：三个字母的ISO 639-3语言代码
    • 值：名称对象
      • 键：official - 官方名称翻译
      • 键：common - 通用名称翻译
  • geo
    • continent - 国家所在的洲
      • 键：两位洲代码
      • 值：英文中的洲名称
    • postal_code - 国家是否使用邮政编码
    • latitude - 纬度坐标点的简短形式
    • latitude_desc - 描述纬度坐标点
    • longitude - 经度坐标点的简短形式
    • longitude_desc - 描述经度坐标点
    • max_latitude - 最大纬度坐标点
    • max_longitude - 最大经度坐标点
    • min_latitude - 最小纬度坐标点
    • min_longitude - 最小经度坐标点
    • area - 国土面积（km²）
    • region - 地理区域
    • subregion - 地理子区域
    • world_region - 地理世界区域
    • region_code - 地理区域数字代码
    • subregion_code - 地理子区域数字代码
    • landlocked - 陆地封锁状态
    • borders - 陆地边界
    • independent - 独立状态
  • 拨号
    • calling_code - 电话代码(们)
    • national_prefix - 国家前缀
    • national_number_lengths - 国家号码长度
    • national_destination_code_lengths - 国家目的地代码长度
    • international_prefix - 国际前缀
  • 额外
    • geonameid - 地名ID
    • edgar - 电子数据收集、分析和检索系统
    • itu - 国际电信联盟分配的代码
    • marc - 美国国会图书馆的机器可读编目代码
    • wmo - 世界气象组织的国家缩写
    • ds - 国际交通中车辆的区分标志
    • fifa - 国际足球联合会分配的代码
    • fips - 美国联邦信息处理标准代码
    • gaul - 联合国粮食及农业组织的全球行政单元层
    • ioc - 国际奥委会分配的代码
    • cowc - 战争相关性字符
    • cown - 战争相关性数字
    • fao - 联合国粮食及农业组织
    • imf - 国际货币基金组织
    • ar5 - 第五次评估报告 (AR5)
    • address_format - 地址格式
    • eu_member - 欧洲联盟成员国
    • vat_rates - 增值税率
    • emoji - 表情符号旗

数据来源

升级

  • 从 v2.x 升级到 v3.x

    没有重大更改，与旧版本API保持100%向后兼容。注意现在 PHP v7.0 是最低要求。

  • 从 v1.x 升级到 v2.x

    整个包从头开始重写，只需丢弃任何以前的代码，开始使用新的清晰、直观的API。

变更日志

请参阅变更日志，了解项目的完整历史。

支持

以下支持渠道随时可供您使用

贡献 & 协议

感谢您考虑为这个项目做出贡献！贡献指南可以在CONTRIBUTING.md中找到。

欢迎提交错误报告、功能请求和拉取请求。

安全漏洞

如果您在此项目中发现安全漏洞，请发送电子邮件至help@sierratecnologia.com。所有安全漏洞都将得到及时处理。

关于 SierraTecnologia

SierraTecnologia是一家成立于2016年6月的埃及亚历山大的软件解决方案初创公司，专注于为中小企业提供集成企业解决方案。我们坚信，我们的动力在于“价值”、“影响”和“作用”，这是我们与众不同的地方，通过软件的力量释放我们哲学的无尽可能性。我们喜欢称之为“与生活同步的创新”。这就是我们如何为人类进步做出贡献的方式。

许可

此软件遵循MIT许可证（MIT）发布。

(c) 2016-2020 SierraTecnologia LLC，部分权利保留。