Download the PHP package yiisoft/translator without Composer

On this page you can find all versions of the php package yiisoft/translator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package translator

Yii

Yii Message Translator


Latest Stable Version Total Downloads Build Status Scrutinizer Code Quality Code Coverage Mutation testing badge static analysis type-coverage

This package allows translating messages into several languages. It can work with both Yii-based applications and standalone PHP applications.

Requirements

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

Built-in message formatters

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:

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 CategorySources 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

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

Open Collective

Follow updates

Official website Twitter Telegram Facebook Slack


All versions of translator with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0
psr/event-dispatcher Version 1.0.0
yiisoft/files Version ^1.0|^2.0
yiisoft/i18n Version ^1.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package yiisoft/translator contains the following files

Loading the files please wait ....