PHP

Traduza strings literais em arrays estáticos de idioma em PHP sem executar código da aplicação.

As aplicações PHP carregam frequentemente mensagens a partir de um ficheiro que devolve um array. O processador de ficheiros php traduz os valores de strings literais desse array e preserva as chaves de pesquisa, os comentários, os números e a sintaxe envolvente. A análise do ficheiro é feita sem executar PHP.

Estrutura de origem suportada #

Por exemplo:

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

Os caminhos para os textos são checkout.title e checkout.delivery. São suportados arrays aninhados com parênteses retos e a sintaxe array(...). As chaves de texto mantêm-se inalteradas, para que a aplicação continue a utilizar os mesmos identificadores nas pesquisas.

Mantenha os valores das mensagens em arrays estáticos. A concatenação, as chamadas a funções e as strings derivadas de variáveis exigem uma avaliação que este analisador não realiza. Um literal encontrado junto de uma expressão não corresponde ao resultado calculado dessa expressão. Mova essas mensagens para valores literais nos recursos antes de confiar na tradução de ficheiros para as selecionar.

Aspas e traduções existentes #

O processador preserva as aspas simples ou duplas que delimitam cada string de origem e aplica às substituições as sequências de escape adequadas a esse delimitador. O resultado entre aspas duplas mantém os elementos de interpolação já presentes na origem, como {$name}, e aplica sequências de escape às sequências com o símbolo de dólar introduzidas de novo. Verifique os marcadores de posição da aplicação, como :days, com os valores fornecidos pelo código que os utiliza.

A comparação incremental utiliza o caminho de cada literal no array devolvido. As mensagens de origem que não sofreram alterações podem manter os respetivos valores de destino aceites. Alterar uma chave muda o identificador utilizado na comparação, mesmo que as palavras em inglês continuem iguais. Os controlos de chaves da CLI permitem bloquear valores de origem, preservar valores de destino e remover entradas ignoradas em ficheiros PHP.

A reconstrução ao nível das chaves pode remover entradas associativas não resolvidas que não tenham um valor de destino. Não assuma que uma execução parcial produz um ficheiro de idioma completo. Reveja as estruturas aninhadas e quaisquer valores posicionais de que a aplicação dependa.

Configurar e validar o ficheiro #

A CLI infere php a partir de .php. Utilize a configuração da CLI ou o GitHub para selecionar os ficheiros de idioma de origem e os respetivos destinos.

Execute php -l no ficheiro de destino e, em seguida, carregue as respetivas mensagens na aplicação. Apresente os textos parametrizados com os valores fornecidos pelo código que os utiliza. No Laravel, a seleção do idioma do pedido e o recurso a um idioma alternativo continuam a depender da configuração da aplicação; o guia Localizar uma aplicação Web explica como ligar o recurso traduzido a esses passos.