panda/l10n

The Panda Localization Package.

Panda Localization Package

This is the localization package of the Panda Platform. It provides a simple translation structure and process for your code., _(*1)

, _(*2)

Installation

This package is part of the Panda Framework but it's also available as a single package., _(*3)

Through the composer

Add the following line to your composer.json file:, _(*4)

"panda/l10n": "^2.0"

Usage

The Translation class works using a given FileProcessor for the translation files. It uses the FileProcessor as a getter to get translations., _(*5)

Each Processor can have its own implementation of handling files based on locale and packages., _(*6)

Translator

The Translator interface can be used across the entire application. You have to define the application's FileProcessor first and then you can load your translations freely., _(*7)

Example:, _(*8)

use Panda\Localization\Translation\JsonProcessor;
use Panda\Localization\Translator;

// Initialize the desired processor
$processor = new JsonProcessor('your_base_directory_for_translations');

// Initialize the Translator
$translator = new Translator($processor);

// Get a desired translation
$translation = $translator->translate('translation-key', 'package-name', 'en_US', 'default-translation-value-if-empty');

JsonProcessor

When using the JsonProcessor, the translation files should be in the given structure:, _(*9)

BASE_DIRECTORY/{locale}/{package}.json

If no package name is given (or an empty package name), the 'default' package will be used (default.json)., _(*10)