PHP

Переводите строковые литералы в статических PHP-массивах локалей, не выполняя код приложения.

PHP-приложения часто загружают сообщения из файла, который возвращает массив. Обработчик файлов php переводит строковые литералы в этом массиве, сохраняя ключи поиска, комментарии, числа и окружающий синтаксис. Он сканирует файл, не выполняя PHP-код.

Поддерживаемая структура исходного файла #

Например:

php
<?php
return [
    'checkout' => [
        'title' => 'Complete your order',
        'delivery' => 'Delivery within :days days',
    ],
];

Пути к текстам — checkout.title и checkout.delivery. Поддерживаются вложенные массивы в квадратных скобках и синтаксис array(...). Строковые ключи не меняются, поэтому приложение продолжает искать сообщения по тем же идентификаторам.

Храните значения сообщений в статических массивах. Конкатенация, вызовы функций и строки, полученные из переменных, требуют вычислений, которые этот сканер не выполняет. Литерал, найденный рядом с выражением, — не результат вычисления этого выражения. Чтобы перевод файла охватывал такие сообщения, сначала перенесите их в ресурсы в виде строковых литералов.

Кавычки и существующие переводы #

Обработчик сохраняет кавычки каждой исходной строки — одинарные или двойные — и экранирует текст перевода с учётом их типа. В строках с двойными кавычками сохраняются токены интерполяции из исходного текста, например {$name}, а новые последовательности со знаком доллара экранируются. Проверяйте плейсхолдеры приложения, например :days, со значениями, которые передаёт вызывающий код.

При инкрементальном сравнении используется путь каждого литерала в возвращаемом массиве. Для неизменённых исходных сообщений можно сохранить принятые переводы. Если изменить ключ, изменится и идентификатор для сравнения, даже если английский текст останется прежним. Средства управления ключами в CLI позволяют фиксировать исходные значения, сохранять переводы и удалять игнорируемые записи из PHP-файлов.

При пересборке по ключам могут удаляться неразрешённые ассоциативные записи без перевода. Не рассчитывайте, что частичный запуск создаст полный файл локали. Проверьте вложенные структуры и все позиционные значения, которые ожидает приложение.

Как настроить и проверить файл #

CLI определяет php по .php. Используйте конфигурацию CLI или GitHub, чтобы выбрать исходные файлы локалей и места сохранения переводов.

Запустите php -l для переведённого файла, затем загрузите его сообщения в приложение. Проверьте, как отображается текст с параметрами, подставив значения, которые передаёт вызывающий код. В Laravel выбор локали запроса и резервной локали по-прежнему настраивается в приложении. В руководстве Как локализовать веб-приложение описано, как связать переведённый ресурс с этими настройками.