Globales & Fonctions¶

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. Vous pouvez fournir des arguments supplémentaires pour remplacer les espaces réservés dans votre chaîne:

__('Vous avez {0} messages non-lus', $number);

Vous pouvez également fournir un tableau associatif de remplacements:

__('Vous avez {unread} messages non-lus', ['unread' => $number]);

Note

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

__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('PluginName', 'Ceci est mon plugin');

__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.

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

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

Le contexte est un identifiant unique pour la chaîne de traductions qui le rend unique dans le même domaine.

__dxn(string $domain, string $context, string $singular, string $plural, integer $count, 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 contexte. 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.

Le contexte est un identifiant unique pour la chaîne de traductions qui le rend unique dans le même domaine.

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

Retourne la forme correcte d’un message identifié par $singular et $plural pour le compteur $count. Certaines langues ont plus d’une forme de pluriel dépendant du compteur.

__x(string $context, string $msg, mixed $args = null)¶

Le contexte est un identifiant unique pour la chaîne de traductions qui le rend unique dans le même domaine.

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

Retourne la forme correcte d’un message identifié par $singular et $plural pour le compteur $count. Cela permet également de spécifier une contexte. Certaines langues ont plus d’une forme de pluriel dépendant du compteur.

Le contexte est un identifiant unique pour la chaîne de traductions qui le rend unique dans le même domaine.

collection(mixed $items)¶

Vous permet d’instancier un objet Cake\Collection\Collection et wrap l’argument passé. le paramètre $items accepte soit un objet Traversable soit un tableau.

debug(mixed $var, boolean $showHtml = null, $showFrom = true)¶

Si la variable $debug du cœur est à true, $var est affiché. Si $showHTML est true ou laissé null, la donnée est formatée pour être visualisée facilement dans un navigateur.

Si $showFrom n’est pas défini à false, debug retournera en sortie la ligne depuis laquelle il a été appelé. Voir aussi Debugger

env(string $key, string $default = null)¶

Nouveau dans la version 3.1.1: Le paramètre $default a été ajouté.

Récupère une variable d’environnement depuis les sources disponibles. Utilisé en secours si $_SERVER ou $_ENV sont désactivés.

Cette fonction émule également PHP_SELF et DOCUMENT_ROOT sur les serveurs ne les supportant pas. En fait, c’est une bonne idée de toujours utiliser env() plutôt que $_SERVER ou getenv() (notamment si vous prévoyez de distribuer le code), puisque c’est un wrapper d’émulation totale.

h(string $text, boolean $double = true, string $charset = null)¶

Raccourci pratique pour htmlspecialchars().

pluginSplit(string $name, boolean $dotAppend = false, string $plugin = null)¶

Divise le nom d’un plugin en notation par point en plugin et classname (nom de classe). Si $name de contient pas de point, alors l’index 0 sera null.

Communément utilisé comme ceci list($plugin, $name) = pluginSplit('Users.User');

namespaceSplit(string $class)¶

Divise le namespace du nom de la classe.

Communément utilisé comme ceci list($namespace, $className) = namespaceSplit('Cake\Core\App');

dd(mixed $var, boolean $showHtml = null)¶

Cette méthode fonctionne comme debug() sauf qu’elle arrêtera l’exécution du script. Si la variable « core » $debug vaut true, $var sera affichée. Si $showHTML vaut true ou est laissée à null, les données seront rendues dans un affichage user-friendly. Plus de détails : Debugger

pr(mixed $var)¶

Raccourci pratique pour print_r(), avec un ajout de balises <pre> autour de la sortie.

pj(mixed $var)¶

JSON pretty print convenience function, with the addition of wrapping <pre> tags around the output.

Il a pour objectif de debugger la représentation JSON des objets et tableaux.

Définitions des constantes du noyau¶

La plupart des constantes suivantes font référence aux chemins dans votre application.

constant APP¶

Chemin absolu du répertoire de l’application avec un slash.

constant APP_DIR¶

La même chose que app ou le nom du répertoire de votre application.

constant CACHE¶

Chemin vers le répertoire de cache. il peut être partagé entre les hôtes dans une configuration multi-serveurs.

constant CAKE¶

Chemin vers le répertoire de CAKE.

constant CAKE_CORE_INCLUDE_PATH¶

Chemin vers la racine du répertoire lib.

constant CONFIG¶

Chemin vers le répertoire config.

constant CORE_PATH¶

Chemin vers le répertoire racine avec un slash à la fin.

constant DS¶

Raccourci pour la constante PHP DIRECTORY_SEPARATOR, qui est égale à / pour Linux et \ pour Windows.

constant LOGS¶

Chemin du répertoire des logs.

constant ROOT¶

Chemin vers le répertoire racine.

constant TESTS¶

Chemin vers le répertoire de test.

constant TMP¶

Chemin vers le répertoire des fichiers temporaires.

WWW\_ROOT

Chemin d’accès complet vers la racine web (webroot).

Définition de Constantes de Temps¶

constant TIME_START¶

timestamp Unix en microseconde au format float du démarrage de l’application.

constant SECOND¶

Égale à 1

constant MINUTE¶

Égale à 60

constant HOUR¶

Égale à 3600

constant DAY¶

Égale à 86400

constant WEEK¶

Égale à 604800

constant MONTH¶

Égale à 2592000

constant YEAR¶

Égale à 31536000