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.

v2.0.0 2025-09-12 14:51 UTC

Requires

• php: ^8.2
• illuminate/database: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

• Christoph Kempen
• Paul Kievits

• currency
• laravel
• countries
• iso_3166_2
• iso_3166_3
• capitals

README

A comprehensive Laravel package for handling countries data with all 249 countries, flags, currencies, regions, and more.

Installation

Install via Composer:

composer require webpatser/laravel-countries

Run the installation command to set up the database:

php artisan countries:install

Quick Usage

use Webpatser\Countries\Countries;

$countries = new Countries();
$usa = $countries->getOne('US');
$allCountries = $countries->getList();
$euroCountries = $countries->getByCurrency('EUR');

Features

• 🌍 All 249 countries with complete data
• 🏳️ Flag emojis for every country
• 💰 Currency information and filtering
• 🌏 Regional grouping and filtering
• 🔍 Search and query capabilities
• 📋 Laravel validation rules
• 🎨 Collection and String macros
• 🗄️ Eloquent model support

Documentation

For complete documentation, examples, and API reference, visit:

https://documentation.downsized.nl/laravel-countries

License

MIT License