rteeom/isoflags

library for easy emoji flags generation from iso country codes

Maintainers

Details

github.com/mainstreamer/isoflags

Source

Issues

Installs: 487

Dependents: 1

Suggesters: 0

Security: 0

Stars: 1

Watchers: 1

Forks: 0

Open Issues: 0

pkg:composer/rteeom/isoflags

v1.3.2 2026-01-04 13:56 UTC

Requires

  • php: ^8.4

Requires (Dev)

MIT 87467d0e33e5c9f0501aa3a27aaa74dea62eb2ff

  • Rteeom <mainstreamer.woop@outlook.com>

This package is auto-updated.

Last update: 2026-01-04 14:24:46 UTC

README

License Latest Stable Version Total Downloads Tests codecov PHP Version

A modern PHP library for generating emoji flags from ISO 3166-1 alpha-2 country codes and extended regional codes.

Features

  • 🚀 Generate emoji flags from ISO country codes
  • 🌍 Extended regional codes support (Kosovo, Ascension Island, etc.)
  • 🛡️ Type-safe with PHP 8.4 enums
  • ✅ 100% test coverage
  • 📦 Zero dependencies - only requires PHP 8.4+

Installation

composer require rteeom/isoflags

Requirements: PHP 8.4 or higher

Quick Start

use Rteeom\FlagsGenerator\FlagsGenerator;

// Generate emoji flags
echo FlagsGenerator::getFlag('gb'); // 🇬🇧
echo FlagsGenerator::getFlag('ua'); // 🇺🇦
echo FlagsGenerator::getFlag('us'); // 🇺🇸

// Safe usage (returns null for invalid codes)
$flag = FlagsGenerator::getFlagOrNull('invalid'); // null

Extended Regional Codes

use Rteeom\FlagsGenerator\FlagsGenerator;
use Rteeom\FlagsGenerator\Enums\CodeSet;

// Kosovo, Ascension Island, and more
echo FlagsGenerator::getFlag('xk', CodeSet::EXTENDED); // 🇽🇰
echo FlagsGenerator::getFlag('ac', CodeSet::EXTENDED); // 🇦🇨

Validation

use Rteeom\FlagsGenerator\CountryCodeValidator;

$isValid = CountryCodeValidator::isValidCountryCode('gb'); // true
$isValid = CountryCodeValidator::isValidCountryCode('invalid'); // false

Documentation

📚 Read the full documentation →

Development

Run Tests

./vendor/bin/phpunit

Code Quality

make qa  # Run all quality checks

See Contributing Guide for details.

Changelog

See CHANGELOG.md for version history.

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

Support

Made with ❤️ by Rteeom