README

通过 RESTful API 获取国家信息

系统要求

• PHP >= 7.3

安装

使用 Composer

• composer require datingvip/php-rest-countries

或者您可以在您的 composer.json 中包含以下内容

• "datingvip/php-rest-countries": "^1.0.0"

使用说明

首先，创建一个新的 RestCountries 实例以配置库供使用

use NNV\RestCountries;

$restCountries = new RestCountries;

一旦注册了 RestCountries 实例，您可以使用它如下

全部

$restCountries->all();

名称

通过国家名称搜索。可以是本地名称、部分名称或全称

$restCountries->byName("viet");

// or with full name
$restCountries->byName("vietnam", true);

代码

通过 ISO 3166-1 2 位或 3 位国家代码搜索

// Single country code
$restCountries->byCodes("vn");

// Multiple country codes
$restCountries->byCodes(["vn", "cn", "th"]);

货币

通过 ISO 4217 货币代码搜索

$restCountries->byCurrency("vnd");

语言

通过 ISO 639-1 语言代码搜索

$restCountries->byLanguage("vi");

首都

通过首都搜索

$restCountries->byCapitalCity("hanoi");

电话区号

通过电话区号搜索

$restCountries->byCallingCode("84");

地区

通过地区搜索：非洲、美洲、亚洲、欧洲、大洋洲

$restCountries->byRegion("asia");

地区组织

通过地区组织搜索

• EU (欧洲联盟)
• EFTA (欧洲自由贸易协会)
• CARICOM (加勒比共同体)
• PA (太平洋联盟)
• AU (非洲联盟)
• USAN (南美洲国家联盟)
• EEU (欧亚经济联盟)
• AL (阿拉伯联盟)
• ASEAN (东南亚国家联盟)
• CAIS (中美洲一体化系统)
• CEFTA (中欧自由贸易协定)
• NAFTA (北美自由贸易协定)
• SAARC (南亚区域合作联盟)

$restCountries->byRegionalBloc("asean");

过滤响应

您可以过滤请求的输出，只包含指定的字段。

// You can use `fields([])` with any available methods

$restCountries->fields(["name", "callingCodes", "capital"])->all();

$restCountries->fields(["name"])->byName("vietnam", true);

$restCountries->fields(["callingCodes"])->byRegionalBloc("asean");