ez-php / i18n

2.5.4 2026-09-26 02:22 UTC

Requires

• php: ^8.5
• ez-php/contracts: ^2.0

Requires (Dev)

• ez-php/docker: ^2.0
• ez-php/testing-application: ^2.0
• friendsofphp/php-cs-fixer: ^3.94
• phpstan/phpstan: ^2.1
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/phpunit: ^13.0

Suggests

• ext-intl: Needed for LocaleFormatter (locale-aware number, currency and date formatting)

MIT

• Andreas Uretschnig

• framework
• php
• i18n
• translation
• internationalization
• localisation
• ez-php

Published on Packagist.org on 2026-09-26 02:27 UTC

README

Internationalisation module for the ez-php framework — file-based translations with dot-notation keys and locale fallback.

Requirements

• PHP 8.5+
• ez-php/framework 0.*

Installation

composer require ez-php/i18n

Setup

Register the service provider:

$app->register(\EzPhp\I18n\TranslatorServiceProvider::class);

Add translation files under lang/{locale}/:

lang/
  en/
    messages.php   → ['welcome' => 'Welcome, :name!']
  de/
    messages.php   → ['welcome' => 'Willkommen, :name!']

Usage

$translator = $app->make(\EzPhp\I18n\Translator::class);

echo $translator->get('messages.welcome', ['name' => 'Alice']);
// Welcome, Alice!

$translator->setLocale('de');
echo $translator->get('messages.welcome', ['name' => 'Alice']);
// Willkommen, Alice!

Plurals

transChoice() accepts the simple pipe form ('no apples|one apple|:count apples', chosen by position) or an ICU plural message, which uses the full CLDR rules of the locale when ext-intl is installed:

// lang/pl/messages.php
'apples' => '{count, plural, one {# jabłko} few {# jabłka} many {# jabłek} other {# jabłka}}',

$translator->transChoice('messages.apples', 22); // "22 jabłka"
$translator->transChoice('messages.apples', 25); // "25 jabłek"

=0 {…} matches an exact count, # is the count, and :placeholders still work. Without ext-intl only =N, one and other are used.

Locale formatting

LocaleFormatter wraps PHP's ext-intl extension to format numbers, currencies, and dates in a locale-aware way:

use EzPhp\I18n\LocaleFormatter;

$fmt = new LocaleFormatter('de_DE');

echo $fmt->number(1234567.89);         // '1.234.567,89'
echo $fmt->currency(9.99, 'EUR');      // '9,99 €'
echo $fmt->date(new \DateTimeImmutable('2024-06-15')); // '15.06.2024'
echo $fmt->dateTime(new \DateTimeImmutable('2024-06-15 14:30:00')); // '15.06.2024, 14:30:00'

Requires PHP's ext-intl extension.

License

MIT — Andreas Uretschnig