PHPackages                             gobline/translator - 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. gobline/translator

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

gobline/translator
==================

Translator component

v2.0.1(10y ago)21462BSD-3-ClausePHPPHP >=5.6.0

Since Nov 14Pushed 9y ago2 watchersCompare

[ Source](https://github.com/gobline/translator)[ Packagist](https://packagist.org/packages/gobline/translator)[ Docs](https://github.com/gobline)[ RSS](/packages/gobline-translator/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependenciesVersions (5)Used By (2)

Translator component
====================

[](#translator-component)

The Translator component aids in building multilingual applications.

Creating the Translator
-----------------------

[](#creating-the-translator)

```
$translator = new Gobline\Translator\Translator();
```

Adding a Translation File
-------------------------

[](#adding-a-translation-file)

```
$translator->addTranslationFile(__DIR__.'./translations/fr/messages.php', 'fr');
```

At the moment, only PHP arrays are supported.

Adding a Directory of Translation Files
---------------------------------------

[](#adding-a-directory-of-translation-files)

```
$translator->addTranslationFile(__DIR__.'./translations/nl', 'nl');
```

The directory will be searched recursively for translations files.

Adding an Array of Translations
-------------------------------

[](#adding-an-array-of-translations)

```
$translator->addTranslationArray(['First name' => 'Vorname'], 'de');
```

Translate a Message
-------------------

[](#translate-a-message)

```
$translator->setDefaultLanguage('fr'); // you can set a default language

$translator->translate('First name'); // no language specified, using def. lang "fr" and returns "Prénom"

$translator->translate('First name', null, 'nl'); // returns "Voornaam"

$translator->translate('First name', null, 'it'); // no Italian translations provided, returns "First name"

$translator->translate('User %1 created', 'John'); // returns "Utilisateur John créé"

$translator->translate('User %1 %2 created', ['John', 'Smith']); // returns "Utilisateur John Smith créé"
```

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

[](#installation)

You can install the Translator component using the dependency management tool [Composer](https://getcomposer.org/). Run the *require* command to resolve and download the dependencies:

```
composer require gobline/translate

```

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity61

Established project with proven stability

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~133 days

Total

4

Last Release

3848d ago

Major Versions

v1.0.1 → v2.0.02015-12-03

PHP version history (2 changes)v1.0.0PHP >=5.5.0

v2.0.0PHP >=5.6.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/1564a230fe2f5125b0504cf6b6fe1e829face1a5d20ec663b3b8d22843312c7d?d=identicon)[mdecaffmeyer](/maintainers/mdecaffmeyer)

---

Tags

internationalizationi18ntranslatetranslatorgobline

### Embed Badge

![Health badge](/badges/gobline-translator/health.svg)

```
[![Health](https://phpackages.com/badges/gobline-translator/health.svg)](https://phpackages.com/packages/gobline-translator)
```

###  Alternatives

[symfony/intl

Provides access to the localization data of the ICU library

2.6k213.6M1.4k](/packages/symfony-intl)[gettext/languages

gettext languages with plural rules

7832.7M12](/packages/gettext-languages)[punic/punic

PHP-Unicode CLDR

1573.0M31](/packages/punic-punic)[om/potrans

Command line tool for translate Gettext with Google Translator API or DeepL API

10520.2k9](/packages/om-potrans)[skillshare/formatphp

Internationalize PHP apps. This library provides an API to format dates, numbers, and strings, including pluralization and handling translations.

8031.5k](/packages/skillshare-formatphp)[jrmajor/fluent

Fluent localization system for PHP

2918.2k7](/packages/jrmajor-fluent)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)