PHPackages                             vldmir/laravel-iso3166 - 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. vldmir/laravel-iso3166

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

vldmir/laravel-iso3166
======================

A Laravel wrapper for the league/iso3166 package.

v1.1.1(1y ago)112MITPHPPHP ^7.2|^8.0

Since Oct 11Pushed 1y ago1 watchersCompare

[ Source](https://github.com/vldmir/laravel-iso3166)[ Packagist](https://packagist.org/packages/vldmir/laravel-iso3166)[ Docs](https://github.com/vldmir/laravel-iso3166)[ RSS](/packages/vldmir-laravel-iso3166/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (3)Used By (0)

Laravel ISO3166
===============

[](#laravel-iso3166)

[![Latest Version on Packagist](https://camo.githubusercontent.com/586576c12913258196978189a2951be5fbdc0d556b4a2c331553587ac9ee0e20/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f766c646d69722f6c61726176656c2d69736f333136362e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vldmir/laravel-iso3166)[![Total Downloads](https://camo.githubusercontent.com/9d786c93c8dc89d04b2ecfa60c2de33bcf1d03411e45355ba8fa0a45ad6bf652/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f766c646d69722f6c61726176656c2d69736f333136362e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vldmir/laravel-iso3166)[![License](https://camo.githubusercontent.com/49b0d1af54f09c6048c86c0fcb9f7cd034cea33ae1157b268c996512a73f916b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f766c646d69722f6c61726176656c2d69736f333136362e7376673f7374796c653d666c61742d737175617265)](https://github.com/vldmir/laravel-iso3166/blob/main/LICENSE.md)

Laravel ISO3166 provides a convenient wrapper for the `league/iso3166` library, allowing you to retrieve country information within your Laravel applications.

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

[](#installation)

Install via Composer:

```
composer require vldmir/laravel-iso3166
```

If using Laravel <5.5, manually add service provider and facade:

```
'providers' => [
    Vldmir\LaravelIso3166\Providers\CountryServiceProvider::class,
],
'aliases' => [
    'CountryService' => Vldmir\LaravelIso3166\Facades\CountryService::class,
],
```

Usage
-----

[](#usage)

```
use CountryService;

// Retrieve country by name
$country = CountryService::getByName('Canada');
echo $country->name;    // Canada
echo $country->alpha2;  // CA

// Retrieve country by alpha-2 code
$country = CountryService::getByAlpha2('US');
echo $country->name;    // United States of America

// Retrieve country by numeric code
$country = CountryService::getByNumeric('124');
echo $country->name;    // Canada
```

Testing
-------

[](#testing)

Run tests using PHPUnit:

```
vendor/bin/phpunit
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for recent changes.

Contributing
------------

[](#contributing)

Contributions are welcome! Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security issues, please email .

Credits
-------

[](#credits)

- [Volodymyr Romantsov](https://github.com/vldmir)

License
-------

[](#license)

The MIT License (MIT). Please see [LICENSE](LICENSE.md) for details.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity45

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

Total

2

Last Release

579d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/28f2149d7afc88386ce2e51326341863bc9b3088ee551269ef76bfd23981d548?d=identicon)[vldmir](/maintainers/vldmir)

---

Top Contributors

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

---

Tags

countryIso3166laravel-iso3166

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/vldmir-laravel-iso3166/health.svg)

```
[![Health](https://phpackages.com/badges/vldmir-laravel-iso3166/health.svg)](https://phpackages.com/packages/vldmir-laravel-iso3166)
```

###  Alternatives

[dougsisk/laravel-country-state

Country & state helper for Laravel.

1681.7M](/packages/dougsisk-laravel-country-state)[dipeshsukhia/laravel-country-state-city-data

Country State City Data Provider

8230.8k](/packages/dipeshsukhia-laravel-country-state-city-data)[stidges/laravel-country-flags

A Laravel wrapper for the stidges/country-flags package

28134.6k](/packages/stidges-laravel-country-flags)[interaction-design-foundation/laravel-geoip

Support for multiple Geographical Location services.

17221.0k3](/packages/interaction-design-foundation-laravel-geoip)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[usamamuneerchaudhary/country-city-state

Country City State Data Provider for Laravel 12+

242.6k](/packages/usamamuneerchaudhary-country-city-state)

PHPackages © 2026

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