PHPackages                             crcl/worlddata - 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. crcl/worlddata

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

crcl/worlddata
==============

Enrich country codes with names, continent, time zone, coordinates, and top-level domains.

v0.4.0(3y ago)17921MITPHPPHP ^8.0.2

Since Feb 28Pushed 3y ago1 watchersCompare

[ Source](https://github.com/CRCL/worlddata)[ Packagist](https://packagist.org/packages/crcl/worlddata)[ RSS](/packages/crcl-worlddata/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (2)Versions (4)Used By (0)

CRCL world data
===============

[](#crcl-world-data)

Enrich country codes with names, continent, time zone, coordinates, and TLDs.

### \*\* Warning \*\* this package is still in development

[](#-warning--this-package-is-still-in-development)

Use at your own risk - before we release a major version, every update can contain compatibility breaks!

Installation / Usage
--------------------

[](#installation--usage)

Download and install this package via composer.

`composer require crcl/worlddata`

```
$oContinents = \CRCL\worlddata\World::continents(); // all continents

$oContinent = \CRCL\worlddata\World::continents()->find('EU'); // Continent instance
$oContinent->code; // EU
$oContinent->name; // Europe
$oContinent->countries(); // [CountryObj1, CountryObj2,..]

$oCountry = \crcl\worlddata\World::countries()->find('DE'); // or use shortcut ::countries('DE')
$oCountry->name; // Germany
$oCountry->coordinates; // [latitude , longitude] of country center
$oCountry->timezones; // [["Europe/Berlin", null]] Countries with multiple time-zones are represented by an array of time-zone name and time-zone longitude pairs.
$oCountry->tld; // .de
$oCountry->continent; // EU
$oCountry->continent(); // ContinentObj

// additional data sets
\crcl\worlddata\World::currencies();
\crcl\worlddata\World::languages();
\crcl\worlddata\World::topLevelDomains();

// useful samples
\crcl\worlddata\World::countries()->groupBy('continent'); // countries grouped by continents
\crcl\worlddata\World::countries()->contains('name', 'Germany') // check by any property
\crcl\worlddata\World::currencies()->exist('USD'); // check by code true
// etc..
```

*Tip!* All collections are an instance of \\Illuminate\\Support\\Collection

Please take a look at [Laravel Collections Doku](https://laravel.com/docs/8.x/collections#available-methods) for all available methods

Requirements
------------

[](#requirements)

Tested and developed under `PHP 8.0`.

Security Reports
----------------

[](#security-reports)

Please send any sensitive issue to . Thanks!

License
-------

[](#license)

This package is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

Data Accuracy
-------------

[](#data-accuracy)

As far as we know, the data is accurate, but we make no guarantees of accuracy or completeness.

Use at your own risk.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 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 ~89 days

Total

3

Last Release

1362d ago

PHP version history (2 changes)v0.2.0PHP ^8.0

v0.4.0PHP ^8.0.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/71af48f60236af5c3446cae8c9baeef8cb138ee28c0d2e37066fb5a5136aef32?d=identicon)[nsabosch](/maintainers/nsabosch)

---

Top Contributors

[![nsabosch](https://avatars.githubusercontent.com/u/3799560?v=4)](https://github.com/nsabosch "nsabosch (8 commits)")

---

Tags

phpcountriescurrenciestimezonestldcontinentsworld-data

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/crcl-worlddata/health.svg)

```
[![Health](https://phpackages.com/badges/crcl-worlddata/health.svg)](https://phpackages.com/packages/crcl-worlddata)
```

###  Alternatives

[pragmarx/countries

PHP Countries and Currencies

1.9k3.3M18](/packages/pragmarx-countries)[rinvex/countries

Rinvex Countries is a simple and lightweight package for retrieving country details with flexibility. A whole bunch of data including name, demonym, capital, iso codes, dialling codes, geo data, currencies, flags, emoji, and other attributes for all 250 countries worldwide at your fingertips.

1.7k7.4M48](/packages/rinvex-countries)[pragmarx/countries-laravel

Countries for Laravel

1471.1M2](/packages/pragmarx-countries-laravel)[webpatser/laravel-countries

Modern Laravel Countries package providing ISO 3166-2, ISO 3166-3, currency, capital and more for all countries. Compatible with Laravel 11.x and 12.x.

8272.8M8](/packages/webpatser-laravel-countries)[dougsisk/laravel-country-state

Country & state helper for Laravel.

1681.7M](/packages/dougsisk-laravel-country-state)[nnjeim/world

Laravel countries, states, cities, currencies, languages and IP geolocation

970361.2k3](/packages/nnjeim-world)

PHPackages © 2026

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