PHPackages                             monkeyscloud/monkeyslegion-i18n - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. monkeyscloud/monkeyslegion-i18n

ActiveLibrary[Localization & i18n](/categories/localization)

monkeyscloud/monkeyslegion-i18n
===============================

Production-ready I18n & localization component for the MonkeysLegion PHP framework

2.0.0(5mo ago)11.0k↑142.9%2MITPHPPHP ^8.4

Since May 24Pushed 5mo agoCompare

[ Source](https://github.com/MonkeysCloud/MonkeysLegion-I18n)[ Packagist](https://packagist.org/packages/monkeyscloud/monkeyslegion-i18n)[ RSS](/packages/monkeyscloud-monkeyslegion-i18n/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (4)Versions (5)Used By (2)

MonkeysLegion I18n
==================

[](#monkeyslegion-i18n)

Production-ready internationalization and localization package for the MonkeysLegion PHP framework.

✨ Features
----------

[](#-features)

- 🌍 **Multiple Translation Sources**: JSON files, PHP arrays, Database, Cache
- 📝 **ICU Pluralization**: Plural rules for 200+ languages
- 🎯 **Auto Locale Detection**: URL, Session, Headers, Cookies
- 🚀 **High Performance**: Built-in caching support
- 🔄 **Fallback Chain**: Locale → Fallback → Default
- 📦 **Namespacing**: Package-level translations (`vendor::file.key`)
- 📊 **Missing Translation Tracking**: Development mode tracking
- 💾 **Hybrid System**: Use JSON files AND database simultaneously

Installation
------------

[](#installation)

```
composer require monkeyscloud/monkeyslegion-i18n
```

**Note**: The `php-intl` extension is optional but recommended for advanced number/date formatting.

Quick Start
-----------

[](#quick-start)

### Basic Usage with JSON Files

[](#basic-usage-with-json-files)

**Step 1: Create translation files**

```
# Create directory structure
mkdir -p resources/lang/en
mkdir -p resources/lang/es
```

**`resources/lang/en/messages.json`**

```
{
  "welcome": "Welcome!",
  "greeting": "Hello, :name!",
  "items": "{0} No items|{1} One item|[2,*] :count items"
}
```

**`resources/lang/es/messages.json`**

```
{
  "welcome": "¡Bienvenido!",
  "greeting": "¡Hola, :name!",
  "items": "{0} Sin artículos|{1} Un artículo|[2,*] :count artículos"
}
```

**Step 2: Use the translator**

```