PHPackages benfiratkaya/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. benfiratkaya/translator ActiveLibrary[Localization & i18n](/categories/localization) benfiratkaya/translator ======================= Translator class for based PHP systems. 1.1.0(7y ago)4111MITPHPPHP >=5.4 Since Mar 22Pushed 6y ago1 watchersCompare [ Source](https://github.com/benfiratkaya/Translator)[ Packagist](https://packagist.org/packages/benfiratkaya/translator)[ Docs](https://github.com/benfiratkaya/Translator)[ RSS](/packages/benfiratkaya-translator/feed)WikiDiscussions master Synced today READMEChangelog (2)Dependencies (2)Versions (3)Used By (0) Translator ========== [](#translator) Translator class for based PHP (>= 5.4) systems. [![Build Status](https://camo.githubusercontent.com/d5085de35ec6f65dea7141108879e37088c51a093f701da02e9b582e69344325/68747470733a2f2f7472617669732d63692e6f72672f62656e66697261746b6179612f5472616e736c61746f722e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/benfiratkaya/Translator)[![Latest Stable Version](https://camo.githubusercontent.com/22acca99c62ca53c60132ab1449c33d947f6d34c85e6a37406835a28c98087c7/68747470733a2f2f706f7365722e707567782e6f72672f62656e66697261746b6179612f7472616e736c61746f722f762f737461626c652e737667)](https://packagist.org/packages/benfiratkaya/translator)[![Total Downloads](https://camo.githubusercontent.com/f310b8d7328bf08170fdc55cd903e90790b004be5880472415795c1cc18de4ef/68747470733a2f2f706f7365722e707567782e6f72672f62656e66697261746b6179612f7472616e736c61746f722f646f776e6c6f6164732e706e67)](https://packagist.org/packages/benfiratkaya/translator)[![License](https://camo.githubusercontent.com/852af14bf151eb1dfe749cc4e93f9ad359d21c128a2d89faecd87079f0b7250d/68747470733a2f2f706f7365722e707567782e6f72672f62656e66697261746b6179612f7472616e736c61746f722f6c6963656e73652e737667)](https://packagist.org/packages/benfiratkaya/translator) About the Project ----------------- [](#about-the-project) #### What is this? [](#what-is-this) It is a PHP class that provides multi-language system service to your website. #### Features: [](#features) - Translate text with variable - Supported types: PHP, PHP (SQL), JSON, INI - Translate SQL querys - Tiny files and best performance - Simple usage - Short functions #### Supported Types [](#supported-types) TypeSupportExamplePHP✔️[Click](https://github.com/benfiratkaya/Translator/blob/master/examples/languages/php/es_ES.php)PHP (SQL)✔️[Click](https://github.com/benfiratkaya/Translator/blob/master/examples/languages/sql/es_ES.php)JSON✔️[Click](https://github.com/benfiratkaya/Translator/blob/master/examples/languages/json/es_ES.json)INI✔️[Click](https://github.com/benfiratkaya/Translator/blob/master/examples/languages/ini/es_ES.ini)Installation & Loading -------------------------- [](#installation--loading) #### Composer (recomended): [](#composer-recomended) > Installation ``` composer require benfiratkaya/translator ``` > Loading ``` use Translator\Translator; use Translator\Exception; include_once 'vendor/autoload.php'; ``` #### Github: [](#github) If you don't use composer in your project you can include files. ``` use Translator\Translator; use Translator\Exception; include_once 'translator/Exception.php'; include_once 'translator/Register.php'; include_once 'translator/Generator.php'; include_once 'translator/Translator.php'; ``` Usage ----- [](#usage) #### Language File: [](#language-file) Supported Types: PHP, PHP (SQL), JSON, INI > PHP (es\_ES.php) ``` return array ( "Hello!" => "Hola!", "Hello %user%" => "Hola %user%" ); ``` > PHP (SQL) (es\_ES.php) ``` // Connect database try { $db = new PDO("mysql:host=localhost;dbname=test", "root", "password"); } catch (PDOException $e) { echo $e->getMessage(); } $words = array(); $query = $db->query('SELECT text_en, text_ts FROM Table'); while ($row = $query->fetch()) { $words[$row['text_en']] = $row['text_es']; } return $words; ``` > JSON (es\_ES.json) ``` { "Hello!": "Hola!", "Hello %user%": "Hola %user%" } ``` > INI (es\_ES.ini) ``` Hello! = Hola! Hello %user% = Hola %user% ``` #### Exception: [](#exception) ``` // Exception try { // Exception Status, Type, Language, Path $translator = new Translator(true, 'json', 'es_ES', 'translator/languages'); // Register Functions: translate(), translator(), t__(), e__() $translator->register(); $translator->setException(true); // true or false // path/lang.type -> /languages/en_US.json $translator->setType('json'); // php, json, ini $translator->setLang('es_ES'); // Language Code. $translator->setPath('translator/languages'); // Language Files Directory // Update Changes $translator->update(); } catch (Exception $e) { echo 'Error: '.$e->errorMessage(); } ``` #### Translate: [](#translate) > Text ``` echo translator('Hello!'); // Output: Hola! ``` > Text With Variable ``` $var = 'Firat Kaya'; echo translator('Hello %user%', array('%user%' => $var)); // Output: Hola Firat Kaya ``` > Other Functions ``` echo translator('Hello!'); // Output: Hola! echo translate('Hello!'); // Output: Hola! echo t__('Hello!'); // Output: Hola! // Does not require the use of 'echo' with this function. e__('Hello!'); // Output: Hola! ``` *For more information, please refer to the [Wiki](https://github.com/benfiratkaya/Translator/wiki)* Useful Links ------------ [](#useful-links) Wiki: Changelog: License ------- [](#license) Distributed under the MIT License. See [`LICENSE`](https://github.com/benfiratkaya/Translator/blob/master/LICENSE) for more information. Contact ------- [](#contact) Firat Kaya - Project Link: ### Health Score 26 — LowBetter than 43% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community8 Small or concentrated contributor base Maturity56 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 ~14 days Total 2 Last Release 2594d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/22c3156714cb5ef9745bf9c32b71230fd95b7d21b5815e1e7ad1618c285ff8b1?d=identicon)[benfiratkaya](/maintainers/benfiratkaya) --- Top Contributors [![benfiratkaya](https://avatars.githubusercontent.com/u/48600092?v=4)](https://github.com/benfiratkaya "benfiratkaya (37 commits)") --- Tags phpphp-translationphp-translatortranslatetranslationtranslatorphptranslatetranslator ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/benfiratkaya-translator/health.svg) ``` [![Health](https://phpackages.com/badges/benfiratkaya-translator/health.svg)](https://phpackages.com/packages/benfiratkaya-translator) ``` ### Alternatives [stichoza/google-translate-php Free Google Translate API PHP Package 2.0k7.6M124](/packages/stichoza-google-translate-php)[gettext/languages gettext languages with plural rules 7530.3M11](/packages/gettext-languages)[punic/punic PHP-Unicode CLDR 1542.9M29](/packages/punic-punic)[kargnas/laravel-ai-translator AI-powered translation tool for Laravel language files 24838.8k1](/packages/kargnas-laravel-ai-translator)[gettext/translator Gettext translator functions 114.6M10](/packages/gettext-translator)[om/potrans Command line tool for translate Gettext with Google Translator API or DeepL API 10515.0k4](/packages/om-potrans) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)