PHPackages                             geobase/countries-data - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. geobase/countries-data

ActiveLibrary[Utility & Helpers](/categories/utility)

geobase/countries-data
======================

Country data in JSON

1.0.5(9y ago)81822MITPHP >=5.6.0

Since Mar 6Pushed 9y ago1 watchersCompare

[ Source](https://github.com/geobase/countries)[ Packagist](https://packagist.org/packages/geobase/countries-data)[ Docs](https://github.com/geobase/countries)[ RSS](/packages/geobase-countries-data/feed)WikiDiscussions master Synced today

READMEChangelog (3)DependenciesVersions (6)Used By (2)

[![](https://camo.githubusercontent.com/69d98ab7880a507173ba7e4c50662aed6fa570e1ead66a58aa99d214c1eb6671/68747470733a2f2f63646e2e7261776769742e636f6d2f67656f626173652f636f756e74726965732f6d61737465722f6c6f676f2e706e67)](https://camo.githubusercontent.com/69d98ab7880a507173ba7e4c50662aed6fa570e1ead66a58aa99d214c1eb6671/68747470733a2f2f63646e2e7261776769742e636f6d2f67656f626173652f636f756e74726965732f6d61737465722f6c6f676f2e706e67)

This library is aimed at providing easy to use country data in JSON format for all programming languages. Feel free to contribute.

Table Of Content
----------------

[](#table-of-content)

1. [Information](#info)
2. [Installation](#installation)\* [JavaScript/Node](#js)\* [PHP](#php)\* [Download](#download)

Information
-----------

[](#information)

This library includes information on countries in multiple languages.

Here is a list of information available for countries:

- **ISO 3166-1 alpha-2** Two-letter country codes defined in ISO 3166-1
- **ISO 3166-1 alpha-3** Three-letter country codes defined in ISO 3166-1
- **Names** Country name in multiple languages, currently only English, French and German
- **Currency** Currency code (eg. EUR)
- **Continent** Continent code (eg. EUR)
- **Population**
- **Area** Area in square KM
- **Capital**
- **Coordinates** Latitude and Longitude for center as well as North, East, South and West coorinates of bounding box
- **Polygon** Shape of the country
- **Time Zone**
- **Regions**

Here is a list of information available for regions:

- **Names** Country name in multiple languages, currently only English, French and German
- **Two letter code** Two-letter region codes (eg. CA)
- **Four letter code** Four-letter region codes (eg. US-CA)
- **Type** Region type (eg. Province, State, Territory, District)
- **Time Zone**
- **Coordinates** Latitude and Longitude for center as well as North, East, South and West coorinates of bounding box

Installation
------------

[](#installation)

### JavaScript/Node

[](#javascriptnode)

To install this library using npm, run the following command:

```
npm install @geobase/countries-data

```

### PHP

[](#php)

To install this library using composer, run the following command:

```
composer require geobase/countries-data

```

### Download

[](#download)

Alternatively, you can [download the latest release](https://github.com/geobase/countries/releases).

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

5

Last Release

3402d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/26227295?v=4)[GeoBase](/maintainers/geobase)[@geobase](https://github.com/geobase)

---

Top Contributors

[![gabrielbull](https://avatars.githubusercontent.com/u/671923?v=4)](https://github.com/gabrielbull "gabrielbull (15 commits)")

### Embed Badge

![Health badge](/badges/geobase-countries-data/health.svg)

```
[![Health](https://phpackages.com/badges/geobase-countries-data/health.svg)](https://phpackages.com/packages/geobase-countries-data)
```

###  Alternatives

[iatstuti/laravel-owns-models

A simple trait to use with models to check whether they own other models.

141.3k](/packages/iatstuti-laravel-owns-models)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)