PHP

Překládejte řetězcové literály ve statických jazykových polích PHP bez spouštění kódu aplikace.

Aplikace v PHP často načítají zprávy ze souboru, který vrací pole. Obslužná rutina pro soubory php překládá řetězcové literály v tomto poli a zachovává vyhledávací klíče, komentáře, čísla i okolní syntaxi. Soubor prochází, aniž by spouštěla PHP.

Podporovaná struktura zdroje #

Například:

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

Cesty k textům jsou checkout.title a checkout.delivery. Podporována jsou vnořená pole zapsaná pomocí hranatých závorek i syntaxe array(...). Řetězcové klíče zůstávají beze změny, takže aplikace při vyhledávání nadále používá stejné identifikátory.

Hodnoty zpráv uchovávejte ve statických polích. Zřetězení, volání funkcí a řetězce odvozené z proměnných vyžadují vyhodnocení, které tento skener neprovádí. Literál nalezený poblíž výrazu není vypočteným výsledkem tohoto výrazu. Než se spolehnete na to, že překlad souboru tyto zprávy vybere, přesuňte je do souborů s textovými zdroji jako literálové hodnoty.

Uvozovky a existující překlady #

Obslužná rutina u každého zdrojového řetězce zachovává ohraničení jednoduchými či dvojitými uvozovkami a podle něj escapuje náhradní text. Výstup ve dvojitých uvozovkách zachovává interpolační tokeny, které už jsou ve zdroji, například {$name}, a escapuje nově vložené sekvence se znakem dolaru. Ověřte zástupné symboly aplikace, například :days, s hodnotami předávanými volajícím kódem.

Přírůstkové porovnávání využívá cestu každého literálu ve vráceném poli. U nezměněných zdrojových zpráv lze zachovat schválené cílové hodnoty. Změna klíče mění identifikátor používaný při porovnávání, i když anglický text zůstane stejný. Možnosti práce s klíči v CLI umožňují uzamknout zdrojové hodnoty, zachovat cílové hodnoty a odstranit ignorované položky v souborech PHP.

Rekonstrukce podle jednotlivých klíčů může odstranit nevyřešené asociativní položky bez cílové hodnoty. Nepředpokládejte, že částečné spuštění vytvoří úplný jazykový soubor. Zkontrolujte vnořené struktury i všechny poziční hodnoty, které vaše aplikace očekává.

Nastavení a ověření souboru #

CLI odvodí php z .php. Pomocí konfigurace CLI nebo GitHub vyberte zdrojové jazykové soubory a jejich cílová umístění.

Spusťte php -l pro cílový soubor a poté načtěte jeho zprávy v aplikaci. Zobrazte texty s parametry a dosaďte do nich hodnoty předávané volajícím kódem. U frameworku Laravel se výběr jazyka pro požadavek i použití záložního jazyka nadále řídí konfigurací aplikace; návod Lokalizace webové aplikace ukazuje, jak přeložený textový zdroj s těmito kroky propojit.