https://github.com/php-gettext/translator
Gettext translator functions
https://github.com/php-gettext/translator
gettext i18n internationalization translator
Last synced: 3 months ago
JSON representation
Gettext translator functions
- Host: GitHub
- URL: https://github.com/php-gettext/translator
- Owner: php-gettext
- License: mit
- Created: 2019-10-28T23:32:53.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-01-09T09:21:16.000Z (6 months ago)
- Last Synced: 2025-04-09T18:18:23.985Z (3 months ago)
- Topics: gettext, i18n, internationalization, translator
- Language: PHP
- Size: 34.2 KB
- Stars: 12
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Translator
[![Latest Version on Packagist][ico-version]][link-packagist]
[![Software License][ico-license]](LICENSE)
[![Total Downloads][ico-downloads]][link-downloads]
Created by Oscar Otero (MIT License)
Translator functions to use with [gettext/gettext](https://github.com/php-gettext/Gettext). Useful if you don't have the native gettext extension for php or want to avoid problems with it.
## Installation
```
composer require gettext/translator
```
## Translator
```php
use Gettext\Translator;
//Create a new instance of the translator
$t = new Translator();
//Load the translations from php files (generated by Gettext\Extractors\PhpArray)
$t->loadTranslations(
'locales/gl/domain1.php',
'locales/gl/domain2.php',
'locales/gl/domain3.php',
);
//Now you can use it in your templates
echo $t->gettext('apple');
```
## GettextTranslator
The class `Gettext\GettextTranslator` uses the gettext extension. It's useful because combines the performance of using real gettext functions but with the same API than `Translator` class, so you can switch to one or other translator without change code of your app.
```php
use Gettext\GettextTranslator;
//Create a new instance
$t = new GettextTranslator();
//It detects the environment variables to set the locale, but you can change it:
$t->setLanguage('gl');
//Load the domains:
$t->loadDomain('messages', 'project/Locale');
//this means you have the file "project/Locale/gl/LC_MESSAGES/messages.mo"
//Now you can use it in your templates
echo $t->gettext('apple');
```
## Translator functions
To ease the use of translations in your php templates, you can use the provided functions:
```php
use Gettext\TranslatorFunctions;
//Register the translator to use the global functions
TranslatorFunctions::register($t);
echo __('apple'); // it's the same than $t->gettext('apple');
```
You can scan the php files containing these functions and extract the values with the PhpCode extractor:
```html
= __('Hello world'); ?>
```
---
Please see [CHANGELOG](CHANGELOG.md) for more information about recent changes and [CONTRIBUTING](CONTRIBUTING.md) for contributing details.
The MIT License (MIT). Please see [LICENSE](LICENSE) for more information.
[ico-version]: https://img.shields.io/packagist/v/gettext/translator.svg?style=flat-square
[ico-license]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square
[ico-downloads]: https://img.shields.io/packagist/dt/gettext/translator.svg?style=flat-square
[link-packagist]: https://packagist.org/packages/gettext/translator
[link-downloads]: https://packagist.org/packages/gettext/translator