3.15.1 Fonctions globales
Voici des fonctions de CakePHP qui sont disponibles globalement. La plupart d'entre elles sont des raccourcis pratiques pour des fonctions PHP dont le nom est long, mais quelques-unes (comme uses()) peuvent être utilisées pour inclure du code ou exécuter d'autres fonctions utiles. Si vous êtes constamment en attente d'une fonction pour accomplir une tâche fréquemment utilisée, c'est ici que ça se passe.
3.15.1.1 __
__(string $string_id, boolean $return = false)
Cette fonction s'occupe de la localisation dans les applications CakePHP. Le paramètre $string_id identifie l'ID pour une traduction et le second paramètre vous permet de déterminer si la fonction affiche automatiquement la chaîne (c'est le comportement par défaut) ou si elle la retourne pour effectuer d'autres traitements (passer un booléen true pour activer ce comportement).
Lisez la section Localisation & Internationalisation pour plus d'information.
3.15.1.2 a
a(mixed $one, $two, $three...)
Retourne un tableau des paramètres utilisés pour appeler la fonction.
print_r(a('un', 'deux'));
// affiche :
array(
[0] => 'un',
[1] => 'deux'
) print_r(a('un', 'deux'));// affiche :array([0] => 'un',[1] => 'deux')
3.15.1.3 aa
Le texte original de cette section a changé depuis qu'il a été traduit. Aidez-nous à corriger cette différence. Vous pouvez :
aa(array $un, $deux, $trois...)
Utilisez pour créer des tableaux associatifs formés par les paramètres utilisés pour appeler la fonction.
Utilisé pour créer des tableaux associatifs formés de paramètres utilisés pour appeler la fonction enveloppante.
echo aa('a','b');
// affiche :
array(
'a' => 'b'
) echo aa('a','b');// affiche :array('a' => 'b')
3.15.1.4 am
am(array $one, $two, $three...)
Fusionne tous les tableaux passés comme paramètres et retourne le tableau résultant.
3.15.1.5 config
Peut être utilisé pour charger des fichiers depuis le dossier config de votre application via include_once. La fonction vérifie l'existence du fichier avant de l'inclure et retourne un booléen. Prends un nombre optionnel d'arguments.
Exemple : config('un_fichier', 'maconfig');
3.15.1.6 convertSlash
convertSlash(string $string)
Convertit les slashes en underscores et supprime le premier et le dernier underscores dans une chaîne. Retourne la chaîne convertie.
3.15.1.7 countdim
countdim(array $array)
Retourne le nombre de dimensions du tableau passé en paramètre.
3.15.1.8 debug
debug(mixed $var, boolean $showHtml = false)
Si le niveau de DEBUG de l'application est différent de zéro, $var est affiché. Si $showHTML est vrai, la donnée est formatée pour être visualisée facilement dans un navigateur.
3.15.1.9 e
e(mixed $data)
Raccourci pratique pour echo().
3.15.1.10 env
env(string $key)
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.
3.15.1.11 fileExistsInPath
fileExistsInPath(string $fichier)
Vérifie que le fichier donné est dans le include_path PHP actuel. Renvoie une valeur booléenne.
3.15.1.12 h
h(string $texte, string $charset = null)
Raccourci pratique pour htmlspecialchars().
3.15.1.13 ife
ife($condition, $siNonVide, $siVide)
Utilisé pour des opérations de styles ternaires. Si $condition n'est pas vide, $siNonVide est retourné, sinon $siVide est retourné.
3.15.1.14 low
low(string $chaine)
Raccourci pratique pour strtolower().
3.15.1.15 paths
paths()
Obtient le chemin de base de CakePHP sous forme d'un tableau indexé. Le tableau résultant contiendra un tableau de chemins indexés par : Models, Behaviors, Controllers, Components, et Helpers.
3.15.1.16 pr
pr(mixed $var)
Raccourci pratique pour print_r(), avec un ajout de balises <pre> autour du résultat (sortie).
3.15.1.17 r
r(string $recherche, string $remplace, string $sujet)
Raccourci pratique pour str_replace().
3.15.1.18 stripslashes_deep
stripslashes_deep(array $valeur)
Enlève récursivement les slashes de la $valeur passée. Renvoie le tableau modifié.
3.15.1.19 up
up(string $chaine)
Raccourci pratique pour strtoupper().
3.15.1.20 uses
uses(string $lib1, $lib2, $lib3...)
Utilisé pour charger les librairies du cœur de CakePHP (trouvables dans cake/libs/). Passer le nom du fichier de librairie sans l'extension '.php'.


























