Команда translation:extract

Команда translation:extract проходит по всем шаблонам и файлам проекта, находит вызовы функции перевода trans и собирает передаваемые в неё строки. Найденные строки записываются в файл переводов указанной локали. Первым параметром передаётся локаль, для которой нужно собрать переводы. Вторым параметром можно указать путь к конкретной папке или файлу для сканирования.

Синтаксис

php bin/console translation:extract locale [path] [options]

Пример

Давайте извлечём строки перевода для локали en из всего проекта:

php bin/console translation:extract en

Результат выполнения команды:

Extracting translation contents and updating catalogues...
New messages extracted from templates and PHP files.

Пример

Давайте создадим шаблон с вызовом функции перевода, а затем извлечём из него строки:

<p>{{ 'article'|trans }}</p>
<p>{{ 'hello'|trans }}</p>

Теперь запустим извлечение для локали en:

php bin/console translation:extract en

После выполнения команды в файле переводов появятся извлечённые строки:

article: article
hello: hello

Пример

Давайте извлечём строки только из конкретной папки проекта:

php bin/console translation:extract en templates/article

Результат выполнения команды:

Extracting translation contents and updating catalogues...
New messages extracted from templates and PHP files.

Пример

Давайте извлечём строки перевода и перезапишем существующий файл переводов:

php bin/console translation:extract en --force

Результат выполнения команды:

Extracting translation contents and updating catalogues...
New messages extracted from templates and PHP files.

Смотрите также

команда translation:pull,
которая загружает переводы из внешнего сервиса
команда translation:push,
которая отправляет переводы во внешний сервис
команда debug:translation,
которая показывает состояние переводов для локали
команда lint:xliff,
которая проверяет синтаксис XLIFF-файлов переводов