PHP
Traduce cadenas literales en arrays estáticos de idioma en PHP sin ejecutar el código de la aplicación.
Las aplicaciones PHP suelen cargar los mensajes desde un archivo que devuelve un array. El gestor de archivos php traduce las cadenas literales de ese array y conserva las claves de búsqueda, los comentarios, los números y la sintaxis que las rodea. Analiza el archivo sin ejecutar PHP.
Estructura de origen admitida #
Por ejemplo:
<?php
return [
'checkout' => [
'title' => 'Complete your order',
'delivery' => 'Delivery within :days days',
],
];Las rutas de los textos son checkout.title y checkout.delivery. Se admiten arrays anidados con corchetes y la sintaxis array(...). Las claves de tipo cadena se mantienen intactas, por lo que la aplicación sigue usando los mismos identificadores en sus búsquedas.
Mantén los valores de los mensajes en arrays estáticos. La concatenación, las llamadas a funciones y las cadenas derivadas de variables requieren una evaluación que este analizador no realiza. Un literal situado junto a una expresión no equivale al resultado calculado de esa expresión. Traslada esos mensajes a valores literales en los recursos antes de confiar en que la traducción de archivos los seleccione.
Uso de comillas y traducciones existentes #
El gestor conserva las comillas simples o dobles que delimitan cada cadena de origen y aplica los escapes necesarios a los valores de sustitución según ese delimitador. La salida entre comillas dobles conserva los tokens de interpolación ya presentes en el origen, como {$name}, y aplica escapes a las nuevas secuencias con signos de dólar. Comprueba los marcadores de posición de la aplicación, como :days, con los valores que proporciona el código que realiza la llamada.
La comparación incremental utiliza la ruta de cada literal en el array devuelto. Los mensajes de origen que no hayan cambiado pueden conservar sus traducciones aceptadas. Cambiar una clave modifica el identificador utilizado en la comparación, aunque las palabras en inglés sigan siendo las mismas. Los controles de claves de la CLI permiten bloquear los valores de origen, conservar las traducciones y eliminar las entradas ignoradas en los archivos PHP.
La reconstrucción por claves puede eliminar entradas asociativas sin resolver que no tengan una traducción. No des por hecho que una ejecución parcial genera un archivo de idioma completo. Revisa las estructuras anidadas y los valores posicionales que espera tu aplicación.
Configura y valida el archivo #
La CLI infiere php a partir de .php. Usa la configuración de la CLI o GitHub para seleccionar los archivos del idioma de origen y sus destinos.
Ejecuta php -l sobre el archivo de destino y, después, carga sus mensajes en la aplicación. Muestra los textos parametrizados con los valores que proporciona el código que los invoca. En Laravel, la selección del idioma de la solicitud y el idioma de reserva siguen dependiendo de la configuración de la aplicación; Localizar una aplicación web vincula el recurso traducido con esos pasos.