PHP

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

Aplicações PHP costumam carregar mensagens de um arquivo que retorna um array. O manipulador de arquivos php traduz os valores de strings literais desse array e preserva as chaves de consulta, os comentários, os números e a sintaxe ao redor. A análise do arquivo é feita sem executar PHP.

Estrutura de origem compatível #

Por exemplo:

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

Os caminhos dos textos são checkout.title e checkout.delivery. Há suporte a arrays aninhados com colchetes e à sintaxe array(...). As chaves de string permanecem inalteradas para que as consultas da aplicação continuem usando os mesmos identificadores.

Mantenha os valores das mensagens em arrays estáticos. Concatenações, chamadas de função e strings derivadas de variáveis exigem uma avaliação que este analisador não realiza. Um literal encontrado perto de uma expressão não corresponde ao resultado calculado por ela. Mova essas mensagens para valores literais nos recursos antes de contar com a tradução de arquivos para selecioná-las.

Aspas e traduções existentes #

O manipulador preserva as aspas simples ou duplas que delimitam cada string de origem e aplica escape às substituições conforme esse delimitador. A saída entre aspas duplas mantém os tokens de interpolação já presentes na origem, como {$name}, e aplica escape às novas sequências com cifrão. Verifique os marcadores de posição da aplicação, como :days, com os valores fornecidos pelo código que faz a chamada.

A comparação incremental usa o caminho de cada literal no array retornado. Mensagens de origem que não sofreram alterações podem manter seus valores de destino já aceitos. Alterar uma chave muda o identificador usado na comparação, mesmo que as palavras em inglês continuem iguais. Os controles de chaves da CLI permitem bloquear valores de origem, preservar valores de destino e remover entradas ignoradas em arquivos PHP.

A reconstrução por chave pode remover entradas associativas não resolvidas que não tenham valor de destino. Não presuma que uma execução parcial produza um arquivo de idioma completo. Revise as estruturas aninhadas e todos os valores posicionais esperados pela aplicação.

Configure e valide o arquivo #

A CLI infere php a partir de .php. Use a configuração da CLI ou o GitHub para selecionar os arquivos do idioma de origem e seus destinos.

Execute php -l no arquivo de destino e, em seguida, carregue suas mensagens na aplicação. Renderize os textos parametrizados com os valores fornecidos pelo código que faz as chamadas. No Laravel, a seleção do idioma da requisição e o idioma alternativo continuam a cargo da configuração da aplicação; Localize uma aplicação web mostra como conectar o recurso traduzido a essas etapas.