Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/teodoroleckie/translate
⚡ Fast, powerful, scalable and customizable php translator library
https://github.com/teodoroleckie/translate
php php-8 php-translation php-translator php8 translate translation translation-files translation-management translations translator
Last synced: 3 days ago
JSON representation
⚡ Fast, powerful, scalable and customizable php translator library
- Host: GitHub
- URL: https://github.com/teodoroleckie/translate
- Owner: teodoroleckie
- License: mit
- Created: 2021-05-12T09:12:14.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2021-05-20T11:21:48.000Z (over 3 years ago)
- Last Synced: 2024-05-02T04:13:13.131Z (5 months ago)
- Topics: php, php-8, php-translation, php-translator, php8, translate, translation, translation-files, translation-management, translations, translator
- Language: PHP
- Homepage:
- Size: 38.1 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
### Fast, powerful, scalable and customizable php translator library
[](https://scrutinizer-ci.com/g/teodoroleckie/translate/?branch=main)
[](https://scrutinizer-ci.com/g/teodoroleckie/translate/build-status/main)
[](https://scrutinizer-ci.com/code-intelligence)
[](https://packagist.org/packages/tleckie/translate)
You can install the package via composer:
```bash
composer require tleckie/translate
```
### Usage
Create an instance of the Translator class to which you will assign a loader.
The loader must have the directory in which the translation files are stored,
it must also indicate the extension of the translation files.
```php
trans('hello');
$trans->trans('other.value');
```
Your translations file should look like this:
```php
"Hola! Bienvenido a mi sitio web!",
'other.value' => "Otro valor",
.
.
.
];
```
The name of the file that stores the translation should look like this:
```bash
/translations/es_ES.php
```
The trans() method takes multiple arguments. The first is the key of the translation
array, it is the value that will be searched for in its corresponding file.
The second argument (optional) is an array of values to be replaced in the translated value.
If you want to add values to your translated text you must indicate it with "%s".
Note that the number of arguments must match the number of "%s".
```php
trans('hello',['John']);
```
Your translations file should look like this:
```php
"Hola %s! Bienvenido a mi sitio web!"
];
```
Even if you configure your translator to load a specific language,
you can also change the language at any time if you need.
```php
trans('hello',['John'],null, 'en_GB');
```
You can create your translation files by specifying the language and country defined
by the provided locale. You can also decide whether to use the same language for different countries.
Regional configuration example:
"en_US" and "en_GB"
In this case, you just need to create a file that has the following name:
```bash
/translations/en.php
```
In that case the following calls will have the same result and will load the translations from the same file.
```php
trans('hello',['John'],null, 'en_GB');
$trans->trans('hello',['John'],null, 'en_US');
```
You can also implement your own loader to connect to your preferred data source.
You simply have to implement the LoaderInterface interface.
That's all! I hope this helps you ;)