Download the PHP package yiisoft/i18n-translator without Composer
On this page you can find all versions of the php package yiisoft/i18n-translator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download yiisoft/i18n-translator
More information about yiisoft/i18n-translator
Files in yiisoft/i18n-translator
Package i18n-translator
Short Description Yii Message Translator
License BSD-3-Clause
Homepage https://www.yiiframework.com/
Informations about the package i18n-translator
Yii Message Translator
This package allows translating messages into several languages. It can work with both Yii-based applications and standalone PHP applications.
Requirements
- PHP 8.0 or higher.
Installation
The package could be installed with Composer:
Additional packages
There are two types of additional packages. Message source provide support of various message storage formats such as PHP arrays or GNU gettext. Message formatters provide extra syntax that is recognized in translated messages.
Message sources
- translator-message-php - PHP file message storage.
- translator-message-db - Database message storage.
- translator-message-gettext - gettext message storage.
Built-in message formatters
- Simple formatter just replaces parameters in messages. Does not take into account the locale.
intl
formatter utilizes PHP intl extension message formatting capabilities.
Extracting messages
The message extraction is done via console extractor that searches for translator message calls and builds translation files.
In some cases you need to do so without using console. If that is your case, check extractor guide.
Configuration
Quick start
First, get a configured instance of event dispatcher. When using a framework it is usually done as:
Configuration depends on the container used so below we'll create an instance manually.
$fallbackLocale
and $eventDispatcher
are optional. Fallback locale is used when no translation was found in the
main locale. Event dispatcher is used to dispatch missing translation events.
Now we've got an instance, but it has no idea where to get translations from. Let's tell it:
That's it. Translator is ready to be used.
Advanced configuration for Yii3 application
After installing the package, you will get the following configuration files in your application config:
config/packages/yiisoft/translator/common.php
config/packages/yiisoft/translator/params.php
You need get implementation of MessageReader
and MessageSource
to complete configuration. See
"Additional packages", "Message sources" above.
The following configuration is for Yii3 application after all needed packages installed:
You need uncomment strings around ApplicationCategorySource
in common.php
and params.php
files:
and params.php
:
Multiple translation sources
Adding many category sources at once
Overriding translation messages
If you use a module that has message translation and want to redefine default translation messages, you can
add your category source with the same categoryName
as used in the module.
During translation CategorySource
s are used from last to first allowing overriding messages of the same
category and ID.
General usage
Using default language and default category
Specifying category and language
Change default locale
Get a current locale, if you don't know set locale
Get a new Translator instance with a locale to be used by default in case locale isn't specified explicitly
Get a new Translator instance with a category to be used by default in case category isn't specified explicitly
Additional info
The package contains interfaces for development of custom formatters, readers, and writers.
Documentation
- Guide: Português - Brasil
- Internals
If you need help or have a question, the Yii Forum is a good place for that. You may also check out other Yii Community Resources.
License
The Yii Message Translator is free software. It is released under the terms of the BSD License.
Please see LICENSE
for more information.
Maintained by Yii Software.
Support the project
Follow updates
All versions of i18n-translator with dependencies
psr/event-dispatcher Version 1.0.0
yiisoft/files Version ^1.0|^2.0
yiisoft/i18n Version ^1.0