jord-jd/translator

A simple PHP internationalisation library

v3.1.0 2026-07-18 09:15 UTC

Requires

• php: >=7.1
• ext-json: *

Requires (Dev)

• phpunit/phpunit: ^7.5 || ^9.6

Replaces

• divineomega/translator: v3.1.0

LGPL-3.0-only

• Jordan Hall

Published on Packagist.org on 2026-07-18 09:15 UTC

README

A small PHP internationalisation library for PHP 7.1 and later.

Installation

composer require jord-jd/translator

Loading translations

Load one or more JSON files, or merge an array supplied by your application. Later data overrides earlier keys.

use JordJD\Translator\Translator;

$translator = new Translator();
$translator->loadTranslationData(__DIR__.'/resources/lang/en.json');
$translator->loadTranslationArray([
    'welcome' => 'Welcome, :name!',
]);

Passing a language to the constructor loads <project>/resources/lang/<language>.json, preserving the original convention.

$translator = new Translator('en');

Translating

echo $translator->translate('welcome', ['name' => 'Jordan']);

$translator->has('welcome');
$translations = $translator->all();

Missing keys and keys whose value is null fall back to the original key. Valid empty strings, zero values, and false values are returned exactly as stored.