ez-php/i18n

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

0.4.1 2026-03-17 21:03 UTC

Requires

• php: ^8.5
• ez-php/contracts: 0.*

Requires (Dev)

• ez-php/docker: 0.*
• ez-php/testing: 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

MIT

• Andreas Uretschnig

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

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!

License

MIT — Andreas Uretschnig