PHP

Traduce cadenas literales en arreglos estáticos de idioma en PHP sin ejecutar el código de la aplicación.

Las aplicaciones PHP suelen cargar mensajes desde un archivo que devuelve un arreglo. El procesador de archivos php traduce las cadenas literales de ese arreglo 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 compatible #

Por ejemplo:

php
<?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 arreglos anidados con corchetes y la sintaxis array(...). Las claves de tipo cadena se mantienen intactas para que la aplicación siga usando los mismos identificadores en las búsquedas.

Mantén los valores de los mensajes en arreglos 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 encontrado junto a una expresión no equivale al resultado calculado de esa expresión. Traslada esos mensajes a recursos con valores literales antes de depender de la traducción de archivos para seleccionarlos.

Comillas y destinos existentes #

El procesador conserva las comillas simples o dobles que delimitan cada cadena de origen y aplica los caracteres de escape correspondientes a los reemplazos. La salida entre comillas dobles conserva los elementos de interpolación que ya están en el origen, como {$name}, y aplica caracteres de escape a las nuevas secuencias con signos de dólar. Verifica los marcadores de posición de la aplicación, como :days, con los valores que proporciona el código que los invoca.

La comparación incremental usa la ruta de cada literal en el arreglo devuelto. Los mensajes de origen que no cambian pueden conservar sus valores de destino aceptados. Cambiar una clave modifica el identificador usado en la comparación, aunque las palabras en inglés sigan siendo las mismas. Los controles de claves de la CLI permiten bloquear valores de origen, conservar valores de destino y eliminar entradas ignoradas en archivos PHP.

La reconstrucción por clave puede eliminar entradas asociativas sin resolver que no tengan un valor de destino. No supongas que una ejecución parcial genera un archivo de idioma completo. Revisa las estructuras anidadas y cualquier valor posicional que espere 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 en el archivo de destino y luego carga sus mensajes en la aplicación. Renderiza 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 respaldo siguen dependiendo de la configuración de la aplicación; Localizar una aplicación web vincula el recurso traducido con esos pasos.