README

Laravel adapter for omisai/php-countries. It registers the Omisai\Countries\Collection in the Laravel service container and exposes it through a facade.

Features

• Registers Omisai\Countries\Collection as a singleton in the container
• Resolves the collection by class name or the countries binding
• Provides a Countries facade
• Supports Laravel 11, 12, and 13

Requirements

• PHP 8.2+
• Laravel 11, 12, or 13

Laravel 13 requires PHP 8.3+, which is enforced by Composer through Laravel's own package constraints.

Installation

Install the package via Composer:

composer require omisai/laravel-countries

Laravel package discovery will register the service provider and facade automatically.

Usage

Resolve the collection from the container:

use Omisai\Countries\Collection;

$countries = app(Collection::class);
$names = $countries->getCountriesName();

Resolve it by binding name:

$countries = app('countries');

Use the facade:

use Omisai\Laravel\Countries\Facades\Countries;

$names = Countries::getCountriesName();
$hungary = Countries::getCountryByAlpha2('HU');

Testing

Run the test suite using Pest:

composer test

Contributing

Please see CONTRIBUTING.md for details on how to contribute to this project.

Security

Please see SECURITY.md for details on reporting security vulnerabilities.

License

This package is open-sourced software licensed under the MIT license.