fajarsulaksono/laravel-countries

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

v1.0.0 2026-07-30 03:27 UTC

Requires

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

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0|^10.0|^11.0
• pestphp/pest: ^2.0|^3.0|^4.0
• pestphp/pest-plugin-laravel: ^2.0|^3.0|^4.0

MIT

• Christoph Kempen
• Paul Kievits

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

Published on Packagist.org on 2026-08-05 02:49 UTC

README

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

Installation

Install via Composer:

composer require fajarsulaksono/laravel-countries

Run the installation command to set up the database:

php artisan countries:install

Quick Usage

use fajarsulaksono\LaravelCountries\Countries;

$countries = new Countries();
$usa = $countries->getOne('US');
// $usa['name']      => 'United States'
// $usa['full_name'] => 'United States of America'
$allCountries = $countries->getList();
$euroCountries = $countries->getByCurrency('EUR');

Features

• 🌍 All 249 countries with complete data
• 🏷️ Common names (name) and official names (full_name)
• 🏳️ 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