PHP
Traduisez les chaînes littérales des tableaux PHP statiques de ressources linguistiques sans exécuter le code de l’application.
Les applications PHP chargent souvent leurs messages depuis un fichier qui renvoie un tableau. Le gestionnaire de fichiers php traduit les chaînes littérales de ce tableau tout en conservant les clés de recherche, les commentaires, les nombres et la syntaxe environnante. Il analyse le fichier sans exécuter PHP.
Structure source prise en charge #
Par exemple :
<?php
return [
'checkout' => [
'title' => 'Complete your order',
'delivery' => 'Delivery within :days days',
],
];Les chemins d’accès aux textes sont checkout.title et checkout.delivery. Les tableaux imbriqués définis entre crochets et la syntaxe array(...) sont pris en charge. Les clés de type chaîne restent inchangées : l’application continue ainsi d’utiliser les mêmes identifiants pour retrouver les messages.
Conservez les valeurs des messages dans des tableaux statiques. La concaténation, les appels de fonctions et les chaînes issues de variables nécessitent une évaluation que cet analyseur n’effectue pas. Une chaîne littérale repérée à proximité d’une expression ne correspond pas au résultat calculé de cette expression. Déplacez ces messages dans des valeurs littérales de ressources avant de vous appuyer sur la traduction de fichiers pour les sélectionner.
Guillemets et valeurs cibles existantes #
Le gestionnaire conserve les guillemets simples ou doubles qui délimitent chaque chaîne source et échappe les valeurs de remplacement en conséquence. Les chaînes produites entre guillemets doubles conservent les jetons d’interpolation déjà présents dans la source, comme {$name}, et échappent les nouvelles séquences contenant un signe dollar. Vérifiez les paramètres de substitution de l’application, comme :days, avec les valeurs fournies par le code appelant.
La comparaison incrémentale s’appuie sur le chemin de chaque chaîne littérale dans le tableau renvoyé. Les messages source inchangés peuvent conserver leurs valeurs cibles acceptées. Modifier une clé change l’identifiant utilisé pour la comparaison, même si le texte anglais reste identique. Les options de gestion des clés de la CLI permettent de verrouiller les valeurs source, de préserver les valeurs cibles et de supprimer les entrées ignorées dans les fichiers PHP.
La reconstruction au niveau des clés peut supprimer les entrées associatives non résolues qui n’ont pas de valeur cible. Ne partez pas du principe qu’une exécution partielle produit un fichier de langue complet. Vérifiez les structures imbriquées ainsi que toutes les valeurs positionnelles attendues par votre application.
Configurer et valider le fichier #
La CLI déduit php de .php. Utilisez la configuration de la CLI ou GitHub pour sélectionner les fichiers de la langue source et leurs destinations.
Exécutez php -l sur le fichier cible, puis chargez ses messages dans l’application. Affichez les textes paramétrés avec les valeurs fournies par le code appelant. Avec Laravel, la sélection de la langue de la requête et la langue de repli restent à configurer dans l’application ; Localiser une application web explique comment relier la ressource traduite à ces étapes.