Constantes globales et Fonctions¶

Alors que la plupart de vos activités quotidiennes avec CakePHP sera d’initialiser des classes du noyau, CakePHP dispose d’un certain nombre de fonctions globales de confort qui peuvent arriver à point nommé. La plupart de ses fonctions sont à utiliser avec les classes cakePHP (classes de chargement ou de component), mais beaucoup d’autres rendent le travail avec les tableaux ou les chaînes de caractères un peu plus simple.

Nous allons aussi couvrir une partie des constantes disponibles dans les applications CakePHP. L’utilisation des constantes disponibles vous aidera à faire des mises à jour plus lisses, mais sont aussi des moyens pratiques pour pointer certains fichiers ou répertoires dans vos applications CakePHP.

Fonctions Globales¶

Voici les fonctions disponibles dans le monde CakePHP. La plupart sont juste des emballages pratiques pour d’autres fonctionnalités CakePHP, comme le débogage et la traduction de contenu.

\_\_(string $string_id, [$formatArgs])

Cette fonction gère la localisation dans les applications CakePHP. $string_id identifie l’ID de la traduction. Les chaînes utilisées pour la traduction sont traitées comme chaîne formatées pour sprintf(). Vous pouvez fournir des arguments supplémentaires pour remplacer les espaces réservés dans votre chaîne:

__('You have %s unread messages', h($number));

Note

Regardez la section Internationalisation & Localisation pour plus d’information.

__c(string $msg, integer $category, mixed $args = null)¶

Notez que la catégorie doit être spécifiée avec une constante de classe I18n, au lieu d’un nom de constante. Les valeurs sont:

I18n::LC_ALL - LC_ALL
I18n::LC_COLLATE - LC_COLLATE
I18n::LC_CTYPE - LC_CTYPE
I18n::LC_MONETARY - LC_MONETARY
I18n::LC_NUMERIC - LC_NUMERIC
I18n::LC_TIME - LC_TIME
I18n::LC_MESSAGES - LC_MESSAGES

__d(string $domain, string $msg, mixed $args = null)¶

Vous permet de remplacer le domaine courant lors de la recherche d’un message.

Utile pour internationaliser un plugin:: echo __d('plugin_name', 'This is my plugin');

__dc(string $domain, string $msg, integer $category, mixed $args = null)¶

Vous permet de remplacer le domaine courant pour la recherche d’un message. Permet également de spécifier une catégorie.

Notez que la catégorie doit être spécifiée avec une constante de classe I18n au lieu du nom de la constante. Les valeurs sont:

I18n::LC_ALL - LC_ALL
I18n::LC_COLLATE - LC_COLLATE
I18n::LC_CTYPE - LC_CTYPE
I18n::LC_MONETARY - LC_MONETARY
I18n::LC_NUMERIC - LC_NUMERIC
I18n::LC_TIME - LC_TIME
I18n::LC_MESSAGES - LC_MESSAGES

__dcn(string $domain, string $singular, string $plural, integer $count, integer $category, mixed $args = null)¶

Vous permet de remplacer le domaine courant pour la recherche simple au pluriel d’un message. Cela permet également de spécifier une catégorie. Retourne la forme correcte d’un message identifié par $singular et $plural pour le compteur $count depuis le domaine $domain. Certaines langues ont plus d’une forme de pluriel dépendant du compteur.

Notez que la catégorie doit être spécifiée avec une des constantes de classe I18n, au lieu des noms de constantes. Les valeurs sont:

I18n::LC_ALL - LC_ALL
I18n::LC_COLLATE - LC_COLLATE
I18n::LC_CTYPE - LC_CTYPE
I18n::LC_MONETARY - LC_MONETARY
I18n::LC_NUMERIC - LC_NUMERIC
I18n::LC_TIME - LC_TIME
I18n::LC_MESSAGES - LC_MESSAGES

__dn(string $domain, string $singular, string $plural, integer $count, mixed $args = null)¶: Vous permet de redéfinir le domaine courant pour une recherche simple au pluriel d’un message. Retourne la forme pluriel correcte d’un message identifié par $singular et $plural pour le compteur $count depuis le domaine $domain.

__x(string $context, string $singular, mixed $args = null)¶: Le contexte est un identifiant unique pour la traduction qui permet de la rendre unique pour un domaine défini.

__xn(string $context, string $singular, string $plural, integer $count, mixed $args = null)¶

Retourne la forme plurielle correcte pour le message identifié par $singular` et $plural pour le compteur $count. Cette méthode vous permet également de définir un « contexte ». Cette méthode est particulièrement pratique car certaines langues ont plus d’une forme pluriel en fonction du nombre de l’objet à mettre au pluriel.