PHPackages                             almacil/php-translate - 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. almacil/php-translate

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

almacil/php-translate
=====================

1.1.0(2y ago)09791MITPHPPHP >=7.0.0

Since Aug 6Pushed 2y ago1 watchersCompare

[ Source](https://github.com/rubenperezlopez/almacil-php-translate)[ Packagist](https://packagist.org/packages/almacil/php-translate)[ GitHub Sponsors](https://github.com/rubenperezlopez)[ RSS](/packages/almacil-php-translate/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependenciesVersions (7)Used By (1)

[![GitHub last commit](https://camo.githubusercontent.com/bfc073bd2c8350401d44f9d42de58295e6ee40d6abcbc3848859503880108f62/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f727562656e706572657a6c6f70657a2f616c6d6163696c2d7068702d7472616e736c617465)](https://camo.githubusercontent.com/bfc073bd2c8350401d44f9d42de58295e6ee40d6abcbc3848859503880108f62/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f727562656e706572657a6c6f70657a2f616c6d6163696c2d7068702d7472616e736c617465)[![GitHub tag (latest by date)](https://camo.githubusercontent.com/5234ece146ddbdeb4c03b030a52bcf1a495e5fd85f6a40db7698c675f111f4a6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f7461672f727562656e706572657a6c6f70657a2f616c6d6163696c2d7068702d7472616e736c6174653f6c6162656c3d6c61737425323076657273696f6e)](https://camo.githubusercontent.com/5234ece146ddbdeb4c03b030a52bcf1a495e5fd85f6a40db7698c675f111f4a6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f7461672f727562656e706572657a6c6f70657a2f616c6d6163696c2d7068702d7472616e736c6174653f6c6162656c3d6c61737425323076657273696f6e)[![Packagist PHP Version Support](https://camo.githubusercontent.com/2f28b2098a3f2a7344f6ae0059c5d2f3deab604bbbca962b78382a896da2e9b3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f616c6d6163696c2f7068702d7472616e736c617465)](https://camo.githubusercontent.com/2f28b2098a3f2a7344f6ae0059c5d2f3deab604bbbca962b78382a896da2e9b3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f616c6d6163696c2f7068702d7472616e736c617465)[![GitHub](https://camo.githubusercontent.com/965f65efbdb18a04942101d25e18ccae2c045272395eb9a1aececefe2cc84d56/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f727562656e706572657a6c6f70657a2f616c6d6163696c2d7068702d7472616e736c617465)](https://camo.githubusercontent.com/965f65efbdb18a04942101d25e18ccae2c045272395eb9a1aececefe2cc84d56/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f727562656e706572657a6c6f70657a2f616c6d6163696c2d7068702d7472616e736c617465)

🈳 Almacil PHP Translate
=======================

[](#-almacil-php-translate)

This is a library written in PHP to internationalize websites and apps made with PHP.

*Do you want to contribute?*
[![Donate 1€](https://camo.githubusercontent.com/e9f10e402d347eae203f34b35b454643412c5923154e1d43b9475c32c32114cc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4275792532306d6525323061253230636f666665652d312545322538322541432d627269676874677265656e3f6c6f676f3d6275796d6561636f66666565266c6f676f436f6c6f723d7768697465266c6162656c436f6c6f723d67726579267374796c653d666f722d7468652d6261646765)](https://www.paypal.com/paypalme/rubenperezlopez/1?target=_blank)

Features
--------

[](#features)

- Translate from json files
- Translate words or phrases on the fly with *Google Translat*e and store to json files

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

[](#installation)

Installation is possible using Composer

```
composer require almacil/php-translate
```

Usage
-----

[](#usage)

Create an instance of \\Almacil\\Translate:

```
// Require composer autoloader
require __DIR__ . '/vendor/autoload.php';

// Language to translate from auto detectable language
$lang = 'en';

// Directory containing the json files with the translations
$directory = __DIR__ . '/i18n';

// We want the library to search for the translations that it cannot find in the files and to include the translations in the files
$findMissingTranslations = true;

// Create de instance
$translate = new \Almacil\Translate($lang, $directory, $findMissingTranslations);
echo $translate->get('Hola mundo!'); // Hello world!
```

Create a function with a short name for ease:

```
// ... after the setup

function t($text, $params = null) {
    global $translate;
    return $translate->get($text, $params);
}

echo '' . t('Hola mundo!') . ''; // Hello World!
```

Params
------

[](#params)

We can include parameters in translations like this:

```
// ./i18n/en.json
{
    "hola-name": "Hello {{name}}!"
}
```

```
// Some PHP file
echo '' . t('hola-name', array('name' => 'Rubén')) . ''; // Hello Rubén!
```

*Do you want to contribute?*
[![Donate 1€](https://camo.githubusercontent.com/e9f10e402d347eae203f34b35b454643412c5923154e1d43b9475c32c32114cc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4275792532306d6525323061253230636f666665652d312545322538322541432d627269676874677265656e3f6c6f676f3d6275796d6561636f66666565266c6f676f436f6c6f723d7768697465266c6162656c436f6c6f723d67726579267374796c653d666f722d7468652d6261646765)](https://www.paypal.com/paypalme/rubenperezlopez/1?target=_blank)

---

Made with ❤️ by developer for developers

###  Health Score

26

—

LowBetter than 40% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~159 days

Recently: every ~199 days

Total

6

Last Release

1039d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5f0782da3f221895ff5593718ad68bf60aacf897dffb9dc462929346fc16e105?d=identicon)[rubenperezlopez](/maintainers/rubenperezlopez)

---

Top Contributors

[![rubenperezlopez](https://avatars.githubusercontent.com/u/26804440?v=4)](https://github.com/rubenperezlopez "rubenperezlopez (2 commits)")

### Embed Badge

![Health badge](/badges/almacil-php-translate/health.svg)

```
[![Health](https://phpackages.com/badges/almacil-php-translate/health.svg)](https://phpackages.com/packages/almacil-php-translate)
```

###  Alternatives

[smarty-gettext/smarty-gettext

Gettext plugin enabling internationalization in Smarty Package files

752.5M8](/packages/smarty-gettext-smarty-gettext)[devaslanphp/auto-translate

Auto generate translation JSON files

6627.3k](/packages/devaslanphp-auto-translate)

PHPackages © 2026

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