geobase/countries

来自公开数据提供者的数据,编译成易于使用的PHP对象

1.0.1 2017-03-06 21:49 UTC

This package is not auto-updated.

Last update: 2024-09-29 00:37:11 UTC


README

Build Status StyleCI Scrutinizer Code Quality Code Coverage Code Climate Latest Stable Version

来自公开数据提供者的数据,编译成易于使用的PHP对象 编辑

  1. 特性
  2. 来源
  3. 需求
  4. 安装
  5. 国家
  6. 地区

特性

  • 多语言(目前仅支持英语、法语和德语)。
  • 国家数据库
  • 地区数据库(目前仅针对加拿大和美国)。

来源

需求

这个库不需要数据库,而是使用JSON文件。

这个库使用PHP 5.6+。

安装

您需要通过composer安装此库。为此,请使用以下命令

composer require geobase/countries

国家

世界上所有国家的数据库。

属性

  • 名称
  • 简码(Alpha-2代码)
  • 代码(Alpha-3代码)
  • 纬度
  • 经度
  • 边界框
  • 货币
  • 大陆
  • 人口
  • 面积
  • 首都
  • 时区

示例

获取所有国家的列表。

use GeoBase\Country\CountryRepository;
$countryCollection = CountryRepository::findAll();

获取英文国家名称。

foreach ($countryCollection as $country) {
   echo $country->getNames()->get('en');
}

按英文国家名称排序。

$countryCollection->orderByName();

地区

美国所有州、联邦区和国土的数据库,加拿大省和地区的数据库。

属性

  • 名称
  • 代码(Alpha-2代码)
  • 国家
  • 类型
  • 纬度
  • 经度
  • 边界框

示例

获取美国所有地区的列表。

use GeoBase\Country\CountryRepository;
use GeoBase\Regions\RegionRepository;

$country = CountryRepository::findByCode('US');
$regionCollection = RegionRepository::findByCountry($country);

获取地区名称和类型(英文)。

foreach ($regionCollection as $region) {
   echo $region->getNames()->get('en') . " is a " . 
       $region->getType()::class . " of the " . 
       $country->getNames()->get('en);
}