This document is for a version of CakePHP that is no longer supported. Please upgrade to a newer release!

Page Contents

Shell I18N

La fonctionnalité i18n de CakePHP utilise les fichiers po comme source de traduction. Cela les rend faciles à intégrer avec des outils tels que poedit ou d’autres outils habituels de traduction.

Le Shell de i18n fournit une façon rapide et simple de générer les fichiers template po. Les fichiers templates peuvent être donnés aux traducteurs afin qu’ils traduisent les chaînes de caractères dans votre application. Une fois que votre traduction est faîte, les fichiers pot peuvent être fusionnés avec les traductions existantes pour aider la mise à jour de vos traductions.

Générer les fichiers POT

Les fichiers POT peuvent être générés pour une application existante en utilisant la commande extract. Cette commande va scanner toutes les fonctions de type __() de l’ensemble de votre application, et extraire les chaînes de caractères. Chaque chaîne unique dans votre application sera combinée en un seul fichier POT:

./Console/cake i18n extract

La commande du dessus va lancer le shell d’extraction. En plus de l’extraction des chaînes de caractères des méthodes __(), les messages de validation des models vont aussi être extraits. Le résultat de cette commande va être la création du fichier app/Locale/default.pot. Vous utilisez le fichier pot comme un template pour créer les fichiers po. Si vous créez manuellement les fichiers po à partir du fichier pot, pensez à bien corriger le Plural-Forms de la ligne d’en-tête.

Générer les fichiers POT pour les plugins

Vous pouvez générer un fichier POT pour un plugin spécifique en faisant:

./Console/cake i18n extract --plugin <Plugin>

Cela générera les fichiers POT requis utilisés dans les plugins.

Messages de Validation de Model

Vous pouvez définir le domaine à utiliser pour les messages de validation extraits dans vos models. Si le model a toujours une propriété $validationDomain, le domaine de validation donnée va être ignoré:

./Console/cake i18n extract --validation-domain validation_errors

Vous pouvez aussi éviter que le shell n’extraie des messages de validation:

./Console/cake i18n extract --ignore-model-validation

Exclure les fichiers

Vous pouvez passer une liste de dossiers séparée par une virgule que vous souhaitez exclure. Tout chemin contenant une partie de chemin avec les valeurs fournies sera ignoré:

./Console/cake i18n extract --exclude Test,Vendor

Eviter l’écrasement des avertissements pour les fichiers POT existants

Nouveau dans la version 2.2.

En ajoutant --overwrite, le script de shell ne va plus vous avertir si un fichier POT existe déjà et va écraser par défaut:

./Console/cake i18n extract --overwrite

Extraire les messages des librairies du coeur de CakePHP

Nouveau dans la version 2.2.

Par défaut, le script de shell d’extraction va vous demander si vous souhaitez extraire les messages utilisés dans les librairies du coeur de CakePHP. Définissez --extract-core à yes ou no pour définir le comportement par défaut.

./Console/cake i18n extract --extract-core yes

ou

./Console/cake i18n extract --extract-core no

Créer les tables utilisées par TranslateBehavior

Le shell i18n peut aussi être utilisé pour initialiser les tables par défaut utilisées par TranslateBehavior:

./Console/cake i18n initdb

Cela va créer la table i18n utilisée par le behavior Translate.