PHPackages h4d/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. h4d/i18n ActiveLibrary[Localization & i18n](/categories/localization) h4d/i18n ======== H4D i18n v1.0.7(9y ago)02381MITPHPPHP >=5.5.9 Since Dec 28Pushed 9y agoCompare [ Source](https://github.com/h4d/i18n)[ Packagist](https://packagist.org/packages/h4d/i18n)[ RSS](/packages/h4d-i18n/feed)WikiDiscussions master Synced 4w ago READMEChangelog (1)Dependencies (1)Versions (9)Used By (1) ¿Qué es esto? ============= [](#qué-es-esto) Es un biblioteca básica para la traducción de cadenas y/o cualquier otra cosa relacionada con la internacionalización y las "locales" del sistema. Instalación vía composer: ========================= [](#instalación-vía-composer) Esta biblioteca puede instalarse vía composer ejecutando: ``` $ composer require h4d/i18n ``` **NOTA**: Para el correcto functionamiento de la bibioteca deben estar instaladas en el sistemas las bibliotecas gettext y los correspondientes paquetes de locales (para cada uno de los idiomas a los que se quiera dar soporte). Por ejemplo, en el caso de la Ubuntu habría que: 1. Instalar gettext: ``` apt-get install gettext ``` 2. Instalar los packs de idiomas que necesitemos, por ejemplo para el español: ``` apt-get install language-pack-es ``` Ejemplos del uso del traductor: =============================== [](#ejemplos-del-uso-del-traductor) Traductor tirando de fichero csv -------------------------------- [](#traductor-tirando-de-fichero-csv) Ejemplo básico de un traductor tirando de ficheros CSV localizados en el directorio *./data*. Los nombres de los ficheros deben coincidir con el del idioma. En el caso del ejemplo debe existir un fichero llamado *es\_ES.csv* en el directorio *./data*. ``` use H4D\I18n\Translator; use H4D\I18n\Translator\Adapters\CsvAdapter; try { // New CSV adaptor instance (CSV file: ./data/es_ES.csv) $adapter = new CsvAdapter('es_ES', [CsvAdapter::OPTION_TRANSLATIONS_DIRECTORY=>__DIR__.'/data']); // New translator instace $translator = new Translator($adapter); // Translate a simple string $translated = $translator->translate('Simple string.'); printf('Translated string: %s' . PHP_EOL, $translated); // Translate a string with vars $translated = $translator->translate('Hello %s!', 'Pakito'); printf('Translated string: %s' . PHP_EOL, $translated); } catch (\Exception $e) { printf('EXCEPTION!!: %s'.PHP_EOL, $e->getMessage()); } ``` Para "capturar" en un fichero las cadenas que no tienen traducción disponible se pueden emplear las siguientes opciones (segundo parámetro del constructor de los adaptadores): - **OPTION\_LOG\_UNTRANSLATED\_STRING** (bool): true=>se capturan del cadenas que no tienen traducción, false=>no se capturan las cadenas sin traducción. - **OPTION\_UNTRANSLATED\_STRING\_LOG\_FILE** (string): Ruta del fichero en la que se guardarán las cadenas sin traducción. ``` // New CSV adaptor instance (CSV file: ./data/es_ES.csv) + capture untranslated strings to ./untranslated.txt $adapter = new CsvAdapter('es_ES', [CsvAdapter::OPTION_TRANSLATIONS_DIRECTORY=>__DIR__.'/data', CsvAdapter::OPTION_LOG_UNTRANSLATED_STRING=>true, CsvAdapter::OPTION_UNTRANSLATED_STRING_LOG_FILE=>__DIR__.'/untranslated.txt']); ``` Traductor tirando de gettext ---------------------------- [](#traductor-tirando-de-gettext) Ejemplo básico de un traductor tirando de ficheros gettext (.mo) localizados en el directorio *./data*. Por requerimientos de gettext, dentro del directorio indicado debe existir una estructura de directorios como la siguiente: ``` . ├── en_GB │   └── LC_MESSAGES │   ├── test.mo │   └── test.po └── es_ES    └── LC_MESSAGES    ├── test.mo    └── test.po ``` Los directorios de idiomas deben seguir el formato *ll\_cc* donde *ll* es un código ISO-639 de dos letras que representa el idioma y *cc* es un código ISO-3166 de dos letras que representa el país. Los ficheros \*.po y \*.mo pueden tener cualquier nombre que queramos. ``` use H4D\I18n\Translator; use H4D\I18n\Translator\Adapters\GettextAdapter; try { // New Gettext adaptor instance (use .mo file located in ./data/es_ES/LC_MESSAGES directory with name "test") $adapter = new GettextAdapter('es_ES.UTF-8', [GettextAdapter::OPTION_TRANSLATIONS_DIRECTORY => __DIR__ . '/data', GettextAdapter::OPTION_TRANSLATIONS_DOMAIN => 'test']); // New translator instace $translator = new Translator($adapter); // Translate a simple string $translated = $translator->translate('Simple string.'); printf('Translated string: %s' . PHP_EOL, $translated); // Translate a string with vars $translated = $translator->translate('Hello %s!', 'Pakito'); printf('Translated string: %s' . PHP_EOL, $translated); } catch (\Exception $e) { printf('EXCEPTION!!: %s'.PHP_EOL, $e->getMessage()); } ``` Al igual que con el adaptador de ficheros CSV se podrían capturar las cadenas sin traducción empleando las opciones **OPTION\_LOG\_UNTRANSLATED\_STRING** y **OPTION\_UNTRANSLATED\_STRING\_LOG\_FILE**. ``` $adapter = new GettextAdapter('es_ES.UTF-8', [GettextAdapter::OPTION_TRANSLATIONS_DIRECTORY => __DIR__ . '/data', GettextAdapter::OPTION_TRANSLATIONS_DOMAIN => 'test', GettextAdapter::OPTION_LOG_UNTRANSLATED_STRING => true, GettextAdapter::OPTION_UNTRANSLATED_STRING_LOG_FILE => __DIR__ . '/unstranslated.txt']); ``` ### Health Score 29 — LowBetter than 57% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity12 Limited adoption so far Community8 Small or concentrated contributor base Maturity63 Established project with proven stability 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 ~47 days Recently: every ~25 days Total 8 Last Release 3508d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/17164968?v=4)[Miguel A. Graña](/maintainers/retrinko)[@retrinko](https://github.com/retrinko) --- Top Contributors [![retrinko](https://avatars.githubusercontent.com/u/17164968?v=4)](https://github.com/retrinko "retrinko (38 commits)") --- Tags i18ntranslatorH4D ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/h4d-i18n/health.svg) ``` [![Health](https://phpackages.com/badges/h4d-i18n/health.svg)](https://phpackages.com/packages/h4d-i18n) ``` ### Alternatives [symfony/string Provides an object-oriented API to strings and deals with bytes, UTF-8 code points and grapheme clusters in a unified way 1.8k759.1M1.2k](/packages/symfony-string)[phpmyadmin/motranslator Translation API for PHP using Gettext MO files 601.8M9](/packages/phpmyadmin-motranslator)[gettext/translator Gettext translator functions 115.0M13](/packages/gettext-translator)[om/potrans Command line tool for translate Gettext with Google Translator API or DeepL API 10518.6k7](/packages/om-potrans)[jrmajor/fluent Fluent localization system for PHP 2718.0k7](/packages/jrmajor-fluent)[johannschopplich/kirby-content-translator DeepL & AI-powered content translation for Kirby CMS 2010.1k](/packages/johannschopplich-kirby-content-translator) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)