CakePHP Cookbook Documentation · Créer vos Propres Exceptions dans votre Application. . . . . . ....

CakePHP Cookbook DocumentationVersion 3.8

Cake Software Foundation

mars 16, 2020

Table des matières

1 CakePHP en un Coup d’Oeil 1Conventions plutôt que Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1La Couche Model (Modèle) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1La Couche View (Vue) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2La Couche Controller (Contrôleur) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Cycle de Requête CakePHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Que le Début . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Lectures Complémentaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 Guide de Démarrage Rapide 11Tutoriel d’un système de gestion de contenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Tutoriel CMS - Création de la base de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Tutoriel CMS - Création du Controller Articles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

3 3.0 Guide de Migration 25Prérequis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Outil d’Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Organisation des Répertoires de l’Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26CakePHP doit être installé avec Composer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Namespaces (Espaces de Noms) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Constantes retirées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Nouvel ORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Notions de base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Paramétrage/Configuration des Objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Shell / Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

i

Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Network\Http . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Network\Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Controller\Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37TestSuite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38View\Helper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39I18n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43L10n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

4 Tutoriels et exemples 49Tutoriel d’un système de gestion de contenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Tutoriel CMS - Création de la base de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Tutoriel CMS - Création du Controller Articles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Tutoriel CMS - Tags et Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Tutoriel CMS - Authentification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Tutoriel de Bookmarker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Tutoriel de Bookmarker Part 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Tutoriel d’un Blog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Tutoriel d’un Blog - Partie 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94Tutoriel d’un Blog - Partie 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Tutoriel d’un Blog - Authentification et Autorisations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

5 Contribuer 119Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Tickets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Normes de codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Guide de Compatibilité Rétroactive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

6 Installation 143Exigences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143Installer CakePHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145Serveur de Développement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146Production . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147A vous de jouer ! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147Réécriture d’URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

7 Configuration 153Configurer votre Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153Chemins de Classe Supplémentaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155Configuration de Inflection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156Variables d’Environnement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156Classe Configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Lire et Ecrire les Fichiers de Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159Bootstrapping CakePHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161Désactiver les tables génériques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

8 Routing 163Tour Rapide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

ii

Connecter les Routes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Créer des Routes RESTful . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178Arguments Passés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Générer des URLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182Routing de Redirection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183Classes Route Personnalisées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184Créer des Paramètres d’URL Persistants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185Gérer les Paramètres Nommés dans les URLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

9 Les Objets Request & Response 191ServerRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198Définir des Cookies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Définir les En-têtes de Requête d’Origine Croisée (Cross Origin Request Headers = CORS) . . . . . . . . . 206Erreurs Communes avec les Responses Immutables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206CookieCollections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

10 Controllers (Contrôleurs) 209Le Controller App . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209Déroulement d’une Requête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210Les Actions du Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210Interactions avec les Vues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211Rediriger vers d’Autres Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Chargement des Models Supplémentaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215Paginer un Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215Configurer les Components à Charger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216Configurer les Helpers à Charger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216Cycle de Vie des Callbacks de la Requête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216Plus sur les Controllers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

11 Views (Vues) 261La View App . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261Templates de Vues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262Utiliser les Blocks de Vues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269Events de View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272Créer vos propres Classes de View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272En savoir plus sur les vues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

12 Accès Base de Données & ORM 371Exemple Rapide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371Pour en savoir plus sur les Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

13 La mise en cache 531Configuration de la classe Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532Ecrire dans un Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534Lire depuis un Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535Suppression d’un Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536Effacer les Données du Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536Utiliser le Cache pour Stocker les Compteurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537Utiliser le Cache pour Stocker les Résultats de Requêtes Courantes . . . . . . . . . . . . . . . . . . . . . . 537Utilisation des Groupes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537Activer ou Désactiver Globalement le Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538Création d’un moteur de stockage pour le Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539

iii

14 Console Bake 541

15 Outils de Console, Shells, & Tasks 543La console de CakePHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543Créer un Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545Les Tâches Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546Shell Helpers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548Appeler d’autres Shells à partir de votre Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548Récupérer les Entrées de l’Utilisateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549Créer des Fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549Sortie de la Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550Niveaux de sortie de la Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550Style de sortie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551Arrêter l’Exécution d’un Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552Méthodes Hook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553Configurer les options et générer de l’aide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554Renommer des Commandes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563Routing dans shells / CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563Plus de sujets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564

16 Debugger 575Debug Basique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575Utiliser la Classe Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576Affichage des Valeurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576Logging With Stack Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577Generating Stack Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577Getting an Excerpt From a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577Utiliser les Logs pour Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578Kit de Debug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578

17 Déploiement 579Déplacer les Fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579Modifier le fichier config/app.php . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579Vérifier Votre Sécurité . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580Définir le Document Root . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580Améliorer les Performances de votre Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580Déployer une Mise à Jour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581

18 Email 583Utilisation basique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584Envoyer les pièces jointes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588Utiliser les Transports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589Envoyer des Messages Rapidement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590Envoyer des Emails depuis CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590Créer des emails réutilisables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591

19 Gestion des Erreurs & Exceptions 593Configuration des Erreurs et des Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593Créer vos Propres Gestionnaires d’Erreurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594Changer le Comportement des Erreurs Fatales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594Classes des Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595Exceptions Intégrées de CakePHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595Utiliser les Exceptions HTTP dans vos Controllers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598Exception Renderer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598

iv

Créer vos Propres Exceptions dans votre Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599Etendre et Implémenter vos Propres Gestionnaires d’Exceptions . . . . . . . . . . . . . . . . . . . . . . . 599

20 Événements système 603Exemple d’Utilisation d’Événement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603Accéder aux Gestionnaires d’Événements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604Events du Cœur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605Enregistrer les Listeners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606Dispatcher les Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609Lecture Supplémentaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612

21 Internationalisation & Localisation 613Internationaliser Votre Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613Utiliser les Fonctions de Traduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615Créer Vos Propres Traducteurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619Localiser les Dates et les Nombres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622Sélection Automatique de Locale Basée sur les Données de Requêtes . . . . . . . . . . . . . . . . . . . . . 623

22 Journalisation (logging) 625Configuration des flux d’un log (journal) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625Journalisation des Erreurs et des Exception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627Interagir avec les Flux de Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628Utilisation de l’Adaptateur FileLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628Logging vers Syslog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628Ecrire dans les logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629Scopes de Journalisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629l’API de Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630Logging Trait . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631Utiliser Monolog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631

23 Formulaires Sans Models 633Créer un Formulaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633Traiter les Données de Requêtes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634Définir des Valeurs pour le Formulaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635Récupérer les Erreurs d’un Formulaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635Invalider un Champ de Formulaire depuis un Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636Créer le HTML avec FormHelper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636

24 Plugins 637Installer un Plugin Avec Composer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637Charger un Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638Configuration du Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639Utiliser un Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640Créer Vos Propres Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640Routes de Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641Controllers du Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642Models du Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643Vues du Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645Assets de Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645Components, Helpers et Behaviors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646Etendez votre Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647Publiez votre Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647

25 REST 649Mise en place Simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649

v

Accepter l’Input dans d’Autres Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652RESTful Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652

26 Sécurité 653Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653

27 Sessions 657Configuration de Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657Gestionnaires de Session intégrés & Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658Configurer les Directives ini . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 660Créer un Gestionnaire de Session Personnalisé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661Accéder à l’Objet Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662Lire & Ecrire les Données de Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663Détruire la Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663Faire une Rotation des Identificateurs de Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664Messages Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664

28 Testing 665Installer PHPUnit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665Tester la Configuration de la Base de Données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666Vérifier la Configuration Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666Conventions des Cas de Test (TestCase) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667Créer Votre Premier Cas de Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667Lancer les Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669Les Callbacks du Cycle de Vie des Cas de Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671Fixtures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671Tester les Classes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676Test d’Intégrations des Controllers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678Tests d’Intégration de la Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688Tester les Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693Tester les Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693Tester les Helpers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695Tester les Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696Créer des Suites de Test (Test Suites) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698Créer des Tests pour les Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698Générer des Tests avec Bake . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699Intégration avec Jenkins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700

29 Validation 703Créer les Validators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703Valider les Données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710Valider les Entities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711Règles de Validation du Cœur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712

30 Classe App 713Trouver les Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713Trouver les Chemins vers les Namespaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713Localiser les Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714Localiser les Themes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714Charger les Fichiers de Vendor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714

31 Collections 717Exemple Rapide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717Liste des Méthodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718Faire une Itération . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718

vi

Filtrer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722Agrégation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723Trier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727Utiliser des Données en Arbre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728Autres Méthodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730

32 Folder & File 737Utilisation Basique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737API de Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738L’API de File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741

33 Hash 745Syntaxe de chemin Hash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745

34 Client Http 761Faire des Requêtes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761Créer des Requêtes Multipart avec des Fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 762Envoyer des Corps de Requête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763Options de la Méthode Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763Authentification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764Créer des Scoped Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766Configurer et Gérer les Cookies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766Objets Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767

35 Inflector 771Résumé des Méthodes d’Inflector et de leurs Sorties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 771Créer des Formes Pluriel et Singulier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772Créer des Formes en CamelCase et en Underscore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772Créer des Formes Lisibles par l’Homme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773Créer des Formes pour les Tables et les Noms de Classe . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773Créer des Noms de Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773Créer des Chaînes d’URL Safe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774Configuration d’Inflexion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774

36 Number 775Formatage des Devises . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776Paramétrage de la Devise par Défaut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776Formatage Des Nombres A Virgules Flottantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777Formatage Des Pourcentages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777Interagir Avec Des Valeurs Lisibles Par L’Homme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777Formatage Des Nombres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 778Formatage Des Différences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779Configurer le Formatage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780

37 Objets Registry 781Charger les Objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 781Attraper les Callbacks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 782Désactiver les Callbacks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 782

38 Text 783Convertion des Chaînes de Caractères en ASCII . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784Créer des chaînes saines pour les URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784Générer des UUIDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784Parseur de chaînes simples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785Formater une chaîne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785

vii

Fixer la largeur d’un texte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786Subrillance de Sous-Chaîne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786Retirer les Liens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 787Tronquer le Texte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 787Tronquer une chaîne par la fin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 788Générer un Extrait . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789Convertir un tableau sous la forme d’une phrase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789

39 Date & Time 791Créer des Instances Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792Manipulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792Formatage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 796Comparer Avec le Present . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 796Comparer Avec les Intervals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 796Dates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 797Dates et Heures Immutables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 797Accepter des Données Requêtées Localisées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 798

40 Xml 799Importer les données vers la classe Xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 799Transformer une Chaîne de Caractères XML en Tableau . . . . . . . . . . . . . . . . . . . . . . . . . . . . 800Transformer un tableau en une chaîne de caractères XML . . . . . . . . . . . . . . . . . . . . . . . . . . . 800

41 Globales & Fonctions 803Fonctions Globales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803Définitions des constantes du noyau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805Définition de Constantes de Temps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 806

42 Chronos 807

43 Debug Kit 809

44 Migrations 811

45 ElasticSearch 813

46 Annexes 8153.x Guide de Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 815Informations générales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 850

PHP Namespace Index 853

Index 855

viii

CHAPITRE 1

CakePHP en un Coup d’Oeil

CakePHP est conçu pour faciliter et simplifier les tâches classiques du développement web. En fournissant une boite àoutil tout-en-un pour vous aider à démarrer, les différentes parties de CakePHP fonctionnent aussi bien ensemble queséparément.

Le but de cette présentation est d’introduire les concepts généraux de CakePHP, et de vous donner un aperçu rapidede la façon dont ces concepts sont mis en œuvre dans CakePHP. Si vous êtes impatient de démarrer un projet, vouspouvez commencer avec le tutoriel, ou vous plonger dans la documentation.

Conventions plutôt que Configuration

CakePHP fournit une structure organisationnelle de base qui comprend les noms de classes, les noms de fichiers,les noms de table de base de données, et d’autres conventions. Même si les conventions peuvent paraître longues àapprendre, en suivant les conventions offertes par CakePHP, vous pouvez éviter les configurations inutiles et construireune structure d’application uniforme ce qui facilite le travail quand vous travaillez sur de multiples projets. Le chapitresur les conventions couvre les différentes conventions utilisées par CakePHP.

La Couche Model (Modèle)

La couche Model représente la partie de l’application qui exécute la logique applicative. Elle est responsable de récu-pérer les données et de les convertir selon des concepts significatifs pour votre application. Cela inclut le traitement,la validation, l’association et beaucoup d’autres tâches concernant la manipulation des données.

Dans le cas d’un réseau social, la couche Model s’occuperait des tâches telles que sauvegarder les données utilisateur,sauvegarder les associations d’amis, enregistrer et récupérer les photos des utilisateurs, trouver des suggestions denouveaux amis, etc . . . Tandis que les objets Models seraient « Friend », « User », « Comment », « Photo ». Si nousvoulions charger des données depuis notre table users, nous pourrions faire :

1

CakePHP Cookbook Documentation, Version 3.8

use Cake\ORM\TableRegistry;

// Prior to 3.6 use TableRegistry::get('Users')$users = TableRegistry::getTableLocator()->get('Users');$query = $users->find();foreach ($query as $row) {

echo $row->username;}

Vous remarquerez peut-être que nous n’avons pas eu à écrire de code avant que nous puissions commencer à travailleravec nos données. En utilisant les conventions, CakePHP utilisera des classes standards pour les classes table et entityqui n’ont pas encore été définies.

Si nous voulions créer un nouvel utilisateur et l’enregistrer (avec validation), nous ferions ceci :

use Cake\ORM\TableRegistry;

// Prior to 3.6 use TableRegistry::get('Users')$users = TableRegistry::getTableLocator()->get('Users');$user = $users->newEntity(['email' => '[email protected]']);$users->save($user);

La Couche View (Vue)

La View retourne une présentation des données modélisées. Etant séparée des objets Model, elle est responsable del’utilisation des informations dont elle dispose pour produire n’importe qu’elle interface de présentation nécessaire àvotre application.

Par exemple, la view pourrait utiliser les données du model pour afficher un template de vue HTML les contenant ouun résultat au format XML pour que d’autres l’utilisent :

// Dans un fichier de template de view, nous afficherons un 'element' pour chaque→˓utilisateur (user).

La couche View fournit un certain nombre d’extensions tels que les Templates, les Elements et les Cells pour vouspermettre de réutiliser votre logique de présentation.

La couche View n’est pas seulement limitée au HTML ou à la représentation en texte de données. Elle peut aussi êtreutilisée pour offrir une grande variété de formats tels que JSON, XML et grâce à une architecture modulable tout autreformat dont vous auriez besoin, comme CSV par exemple.

La Couche Controller (Contrôleur)

La couche Controller gère les requêtes des utilisateurs. Elle est responsable de retourner une réponse avec l’aidemutuelle des couches Model et View.

Les Controllers peuvent être imaginés comme des managers qui ont pour mission que toutes les ressources nécessairespour accomplir une tâche soient déléguées aux bonnes personnes. Il attend des requêtes des clients, vérifie leur validitéselon l’authentification et les règles d’autorisation, délègue la récupération et le traitement des données à la couche

2 Chapitre 1. CakePHP en un Coup d’Oeil


Model, puis sélectionne les types de présentation acceptés par le client pour finalement déléguer le processus de renduà la couche View. Un exemple de controller d’enregistrement d’utilisateur serait :

public function add(){

$user = $this->Users->newEntity();if ($this->request->is('post')) {

$user = $this->Users->patchEntity($user, $this->request->getData());if ($this->Users->save($user, ['validate' => 'registration'])) {

$this->Flash->success(__('Vous êtes maintenant enregistré.'));} else {

$this->Flash->error(__('Il y a eu un problème.'));}

}$this->set('user', $user);

}

Notez que nous n’avons jamais explicitement rendu de view. Les conventions de CakePHP prendront soin de sélec-tionner la bonne view et de la rendre avec les données préparées avec set().

Cycle de Requête CakePHP

Maintenant que vous êtes familier avec les différentes couches de CakePHP, voyons comment fonctionne le cycled’une requête CakePHP :

Le cycle d’une requête CakePHP typique débute avec une requête utilisateur qui demande une page ou une ressourcede votre application. À haut niveau chaque requête passe par les étapes suivantes :

1. Les règles de réécriture de votre serveur web dirigent la requête vers webroot/index.php.2. Votre Application est chargée et liée à un HttpServer.

3. Le middleware de votre application est initialisé.

4. Une requête et une réponse sont dispatchées à travers le Middleware PSR-7 utilisé par votre application. Typi-quement, il inclut l’interception d’erreurs et le routing.

5. Si aucune réponse n’est retournée à partir du middleware et que la requête contient des informations de routing,un controller et une action sont sélectionnés.

6. L’action du controller est appelée et le controller interagit avec les Models et Components nécessaires.

7. Le controller délègue la création de la response à la View pour générer le résultat obtenu à partir des donnéesdu model.

8. Le View utilise les Helpers et les Cells pour générer l’en-tête et le corps de la réponse.

9. La réponse est de nouveau envoyée à travers le /controllers/middleware.

10. HttpServer émet la réponse au serveur web.

Que le Début

Espérons que ce bref aperçu ait éveillé votre intérêt. Quelques autres grandes fonctionnalités de CakePHP sont :— Un framework de cache qui s’intègre à Memcached, Redis et d’autres moteurs de cache.— Un outil de génération de code puissant pour partir sur les chapeaux de roue.— Un framework de tests intégré pour vous assurer que votre code fonctionne correctement.

Les prochaines étapes évidentes sont de télécharger CakePHP, lire le tutoriel et construire un truc génial.

Cycle de Requête CakePHP 3


Lectures Complémentaires

Où obtenir de l’aide

Le Site Officiel de CakePHP

https://cakephp.org

Le site officiel de CakePHP est toujours un endroit épatant à visiter. Il propose des liens vers des outils fréquemmentutilisés par le développeur, des didacticiels vidéo, des possibilités de faire un don et des téléchargements.

Le Cookbook

https://book.cakephp.org

Ce manuel devrait probablement être le premier endroit où vous rendre pour obtenir des réponses. Comme pour beau-coup d’autres projets open source, nous accueillons de nouvelles personnes régulièrement. Faîtes tout votre possiblepour répondre à vos questions vous-même dans un premier temps. Les réponses peuvent venir lentement, mais ellesresteront longtemps et vous aurez ainsi allégé notre charge de travail en support utilisateur. Le manuel et l’API onttous deux une version en ligne.

La Boulangerie

https://bakery.cakephp.org

La Boulangerie (Bakery) est une chambre de compensation pour tout ce qui concerne CakePHP. Vous y trouverez destutoriels, des études de cas et des exemples de code. Lorsque vous serez familiarisés avec CakePHP, connectez-vouspour partager vos connaissances avec la communauté et obtenez en un instant la gloire et la fortune.

L’API

https://api.cakephp.org/

Allez droit au but et atteignez le graal des développeurs, l’API CakePHP (Application Programming Interface) estla documentation la plus complète sur tous les détails essentiels au fonctionnement interne du framework. C’est uneréférence directe au code, donc apportez votre chapeau à hélice.

Les Cas de Test

Si vous avez toujours le sentiment que l’information fournie par l’API est insuffisante, regardez le code des cas detest fournis avec CakePHP. Ils peuvent servir d’exemples pratiques pour l’utilisation d’une fonction et de donnéesmembres d’une classe :

tests/TestCase/

Le Canal IRC

Canaux IRC sur irc.freenode.net :— #cakephp – Discussion générale.— #cakephp-docs – Documentation.— #cakephp-bakery – Bakery.

Lectures Complémentaires 5

https://cakephp.orghttps://book.cakephp.orghttps://bakery.cakephp.orghttps://api.cakephp.org/irc://irc.freenode.net/cakephpirc://irc.freenode.net/cakephp-docsirc://irc.freenode.net/cakephp-bakery


— #cakephp-fr – Canal francophone.Si vous êtes paumé, poussez un hurlement sur le canal IRC de CakePHP. Une personne de l’équipe de développement 4

s’y trouve habituellement, en particulier durant les heures du jour pour les utilisateurs d’Amérique du Nord et du Sud.Nous serions ravis de vous écouter, que vous ayez besoin d’un peu d’aide, que vous vouliez trouver des utilisateursdans votre région ou que vous souhaitiez donner votre nouvelle marque de voiture sportive.

Forum Officiel

Forum Officiel de CakePHP 5

Notre forum officiel où vous pouvez demander de l’aide, suggérer des idées et discuter de CakePHP. C’est l’endroitidéal pour trouver rapidement des réponses et aider les autres. Rejoignez la famille de CakePHP en vous y inscrivant.

Stackoverflow

https://stackoverflow.com/ 6

Taggez vos questions avec cakephp et la version spécifique que vous utilisez pour activer les utilisateurs existants destackoverflow pour trouver vos questions.

Où Trouver de l’Aide dans Votre Langue

Portugais brésilien

— Communauté de CakePHP brésilienne 7

Danoise

— Canal CakePHP danois sur Slack 8

Française

— Communauté de CakePHP Francophone 9

Allemande

— Canal CakePHP allemand sur Slack 10

— Groupe Facebook CakePHP Allemand 11

4. https://github.com/cakephp?tab=members5. http://discourse.cakephp.org6. https://stackoverflow.com/questions/tagged/cakephp/7. http://cakephp-br.org8. https://cakesf.slack.com/messages/denmark/9. http://cakephp-fr.org

10. https://cakesf.slack.com/messages/german/11. https://www.facebook.com/groups/146324018754907/


irc://irc.freenode.net/cakephp-frhttps://github.com/cakephp?tab=membershttp://discourse.cakephp.orghttps://stackoverflow.com/questions/tagged/cakephp/http://cakephp-br.orghttps://cakesf.slack.com/messages/denmark/http://cakephp-fr.orghttps://cakesf.slack.com/messages/german/https://www.facebook.com/groups/146324018754907/


Iranienne

— Communauté CakePHP Iranienne 12

Hollandaise

— Canal CakePHP hollandais sur Slack 13

Japonaise

— Canal Slack CakePHP japonais 14

— Groupe Facebook CakePHP japonais 15

Portugaise

— Groupe Google CakePHP protugais 16

Espagnol

— Canal CakePHP espagnol sur Slack 17

— Canal IRC de CakePHP espagnol— Groupe Google de CakePHP espagnol 18

Conventions de CakePHP

Nous sommes de grands fans des conventions plutôt que de la configuration. Bien que cela réclame un peu de tempspour apprendre les conventions de CakePHP, à terme vous gagnerez du temps. En suivant les conventions, vous aurezdes fonctionnalités automatiques et vous vous libérerez du cauchemar de la maintenance du suivi des fichiers de confi-guration. Les conventions créent un environnement de développement uniforme, permettant à d’autres développeursde s’investir dans le code plus.

Les Conventions des Controllers

Les noms des classes de controller sont au pluriel, en CamelCase et se terminent par Controller.UsersController et ArticleCategoriesController sont des exemples respectant cette convention.

les méthodes publiques des controllers sont souvent exposées comme des “actions” accessibles via un navigateur web.Par exemple /users/view correspond à la méthode view() de UsersController sans rien modifier. Lesméthodes privées ou protégées ne sont pas accessibles avec le routing.

12. http://cakephp.ir13. https://cakesf.slack.com/messages/netherlands/14. https://cakesf.slack.com/messages/japanese/15. https://www.facebook.com/groups/304490963004377/16. http://groups.google.com/group/cakephp-pt17. https://cakesf.slack.com/messages/spanish/18. http://groups.google.com/group/cakephp-esp


http://cakephp.irhttps://cakesf.slack.com/messages/netherlands/https://cakesf.slack.com/messages/japanese/https://www.facebook.com/groups/304490963004377/http://groups.google.com/group/cakephp-pthttps://cakesf.slack.com/messages/spanish/irc://irc.freenode.net/cakephp-eshttp://groups.google.com/group/cakephp-esp


Considérations concernant les URLs et les Noms des Controllers

Comme vous venez de voir, un controller à mot unique renvoie vers un chemin URL en minuscules. Par exemple,UsersController (qui serait défini dans le nom de fichier UsersController.php) est accessible à l’adresse http://exemple.com/users.

Alors que vous pouvez router des controllers qui ont plusieurs mots de la façon que vous sou-haitez, la convention est que vos URLs soient en minuscules avec des tirets en utilisant la classeDashedRoute, donc /article-categories/view-all est la bonne forme pour accéder à l’actionArticleCategoriesController::viewAll().

Quand vous créez des liens en utilisant this->Html->link(), vous pouvez utiliser les conventions suivantes pourle tableau d’url :

$this->Html->link('link-title', ['prefix' => 'MyPrefix' // CamelCased'plugin' => 'MyPlugin', // CamelCased'controller' => 'ControllerName', // CamelCased'action' => 'actionName' // camelBacked

]

Pour plus d’informations sur les URLs de CakePHP et la gestion des paramètres, allez voir Connecter les Routes.

Conventions des Fichiers et des Noms de Classe

En général, les noms de fichiers correspondent aux noms des classes et suivent les standards PSR-0 et PSR-4 pourl’autoloading (chargement automatique). Voici quelques exemples de noms de classes et de fichiers :

— La classe controller LatestArticlesController devra se trouver dans un fichier nommé LatestArti-clesController.php.

— La classe Component (Composant) MyHandyComponent devra se trouver dans un fichier nommé MyHan-dyComponent.php.

— La classe Table OptionValuesTable devra se trouver dans un fichier nommé OptionValuesTable.php.— La classe Entity OptionValue devra se trouver dans un fichier nommé OptionValue.php.— La classe Behavior (Comportement) EspeciallyFunkableBehavior devra se trouver dans un fichier

nommé EspeciallyFunkableBehavior.php.— La classe View (Vue) SuperSimpleView devra se trouver dans un fichier nommé SuperSimpleView.ctp.— La classe Helper (Assistant) BestEverHelper devra se trouver dans un fichier nommé BestEverHel-

per.php.Chaque fichier sera situé dans le répertoire/namespace approprié dans le dossier de votre application.

Conventions pour les Models et les Bases de Données

Les noms de classe de model sont au pluriel, en CamelCase et finissent par Table. UsersTable,ArticleCategoriesTable et UserFavoritePagesTable en sont des exemples.

Les noms de tables correspondant aux models CakePHP sont au pluriel et utilisent le caractère souligné (un-derscore). Les tables correspondantes aux models mentionnés ci-dessus seront donc respectivement : users,article_categories et user_favorite_pages.

La convention est d’utiliser des mots anglais pour les noms de colonne et de table. Si vous utilisez des mots dans uneautre langue, CakePHP ne va pas pouvoir convertir correctement les bonnes inflections (du singulier vers le plurielet vice-versa). Dans certains cas, si vous souhaitez ajouter vos propres règles pour des mots d’une autre langue,vous pouvez utiliser la classe utilitaire Cake\Utility\Inflector. En plus de définir ces règles d’inflectionspersonnalisées, cette classe va aussi vous permettre de vérifier que CakePHP comprend votre syntaxe personnaliséepour les mots pluriels et singuliers. Vous pouvez consulter la documentation sur Inflector pour plus d’informations.


http://exemple.com/usershttp://exemple.com/users


Les noms des champs avec deux mots ou plus doivent être avec des underscores comme ici : first_name.

Les clés étrangères des relations hasMany, belongsTo ou hasOne sont reconnues par défaut grâce au nom (singulier)de la table associée, suivi de _id. Donc, si Users hasMany Articles, la table articles se référera à la table usersvia une clé étrangère user_id. Pour une table avec un nom de plusieurs mots comme article_categories, laclé étrangère sera article_category_id.

Les tables de jointure utilisées dans les relations BelongsToMany entre models doivent être nommées d’après le nomdes tables qu’elles unissent ou la commande bake ne fonctionnera pas, dans l’ordre alphabétique (articles_tagsplutôt que tags_articles). Dans le cas où vous souhaitez ajouter des données supplémentaires à la table intermé-diaire, vous devrez ajouter un champ id à la table de jointure pour que articles_tags devienne une entity et latable aura au moins les clés article_id, tag_id et id.

En plus de l’utilisation des clés auto-incrémentées en tant que clés primaires, vous voudrez peut-être aussi utiliser descolonnes UUID. CakePHP va créer un UUID unique de 36 caractères (CakeUtilityText::uuid()) à chaquefois que vous sauvegarderez un nouvel enregistrement en utlisant la méthode Table::save().

Conventions des Views

Les fichiers de template de view sont nommés d’après les fonctions du controller qu’elles affichent, sous une formeavec underscores. La fonction viewAll() de la classe ArticlesController cherchera un gabarit de view danssrc/Template/Articles/view_all.ctp.

Le schéma classique est src/Template/Controller/nom_de_fonction_avec_underscore.ctp.

En utilisant les conventions CakePHP dans le nommage des différentes parties de votre application, vous gagnerez desfonctionnalités sans les tracas et les affres de la configuration. Voici un exemple récapitulant les conventions abordées :

— Nom de la table de la base de données : « articles »— Classe Table : ArticlesTable se trouvant dans src/Model/Table/ArticlesTable.php— Classe Entity : Article se trouvant dans src/Model/Entity/Article.php— Classe Controller : ArticlesController se trouvant dans src/Controller/ArticlesController.php— Template de View se trouvant dans src/Template/Articles/index.ctp

En utilisant ces conventions, CakePHP sait qu’une requête de type http://exemple.com/articles/ sera liée à un appel àla fonction index() du Controller ArticlesController, dans lequel le model Articles est automatiquement disponible(et automatiquement lié à la table “articles” dans la base) et rendue dans un fichier. Aucune de ces relations n’a étéconfigurée par rien d’autre que la création des classes et des fichiers dont vous aviez besoin de toute façon.

Maintenant que vous avez été initié aux fondamentaux de CakePHP, vous devriez essayer de dérouler le tutoriel duBlog CakePHP pour voir comment les choses s’articulent.

Structure du dossier de CakePHP

Après avoir téléchargé et extrait l’application CakePHP, voici les fichiers et répertoires que vous devriez voir :— Le dossier bin contient les exécutables de la console Cake.— Le dossier config contient les (quelques) fichiers de Configuration que CakePHP utilise. Les détails sur la

connexion à la base de données, le bootstrapping, les fichiers de configuration du cœur et consorts doivent êtrestockés ici.

— Le dossier logs contient normalement vos fichiers de log avec la configuration par défaut des logs.— Le dossier plugins est l’endroit où sont stockés les Plugins que votre application utilise.— Le dossier src sera celui vous placerez les fichiers de votre application.— Le dossier tests est l’endroit où vous mettez les cas de test pour votre application.— Le dossier tmp est l’endroit où CakePHP stocke les données temporaires. Les données qu’il stocke dépendent

de la façon dont vous avez configuré CakePHP mais ce dossier est généralement utilisé pour les stocker lestraductions, les descriptions de model et parfois les informations de session.


http://exemple.com/articles/


— Le dossier vendor est l’endroit où CakePHP et d’autres dépendances de l’application vont être installés. Mo-difier ces fichiers est déconseillé car composer écraser vos changements lors du prochain update que vousferez.

— Le répertoire webroot est la racine publique de votre application. Il contient tous les fichiers que vous souhaitezvoir accessibles publiquement.Assurez-vous que les dossiers tmp et logs existent et qu’ils sont en écriture, autrement la performance de votreapplication sera sévèrement impactée. En mode debug, CakePHP vous avertira que ces dossiers ne peuvent pasêtre écrits.

Le Dossier Src

Le répertoire src de CakePHP est l’endroit où vous réaliserez la majorité du développement de votre application.Regardons d’un peu plus près les dossiers à l’intérieur de src.

Controller Contient les controllers et les components de votre application.Locale Stocke les fichiers pour l’internationalisation.Model Pour les tables, entity et behaviors de votre application.Shell Contient les commandes de la console et les tasks de la console pour votre application. Pour plus d’infor-

mations, regardez la section Outils de Console, Shells, & Tasks.

Template Les fichiers de présentation se trouvent ici : elements, pages d’erreur, les layouts, et les fichiers detemplate de vue.

View Les classes de présentation sont placés ici : views, cells, helpers.


CHAPITRE 2

Guide de Démarrage Rapide

Le meilleur moyen de tester et d’apprendre CakePHP est de s’assoir et de construire une application simple de gestionde Contenu (CMS).

Tutoriel d’un système de gestion de contenu

Ce tutoriel vous accompagnera dans la création d’une application de type CMS (Content Management System). Pourcommencer, nous installerons CakePHP, créerons notre base de données et construirons un système simple de gestiond’articles.

Voici les pré-requis :

1. Un serveur de base de données. Nous utiliserons MySQL dans ce tutoriel. Vous avez besoin de connaître assezde SQL pour créer une base de données et exécuter quelques requêtes SQL que nous fournirons dans ce tutoriel.CakePHP se chargera de construire les requêtes nécessaires pour votre application. Puisque nous allons utiliserMySQL, assurez-vous que pdo_mysql est bien activé dans PHP.

2. Les connaissances de base en PHP.

Avant de commencer, assurez-vous que votre version de PHP est à jour :

php -v

Vous devez avoir au minimum PHP 5.6 installé (en CLI). Votre version serveur de PHP doit au moins être aussi 5.6 et,dans l’idéal, devrait également être la même que pour votre version en ligne de commande (CLI).

Récupérer CakePHP

La manière la plus simple d’installer CakePHP est d’utiliser Composer. Composer est une manière simple d’installerCakePHP via votre terminal. Premièrement, vous devez télécharger et installer Composer si vous ne l’avez pas déjàfait. Si vous avez cURL installé, il suffit simplement de lancer la commande suivante :

11


curl -s https://getcomposer.org/installer | php

Ou vous pouvez télécharger composer.phar depuis le site de Composer 19.

Ensuite, tapez la commande suivante dans votre terminal pour installer le squelette d’application CakePHP dans ledossier cms du dossier courant :

php composer.phar create-project --prefer-dist cakephp/app:^3.8 cms

Si vous avez téléchargé et utilisé l’Installer de Composer pour Windows 20, tapez la commande suivante dans votreterminal depuis le dossier d’installation (par exemple C :\wamp\www\dev\cakephp3) :

composer self-update && composer create-project --prefer-dist cakephp/app:^3.8 cms

Utiliser Composer a l’avantage d’exécuter automatiquement certaines tâches importantes d’installation, comme définirles bonnes permissions sur les dossiers et créer votre fichier config/app.php.

Il existe d’autres moyens d’installer CakePHP. Si vous ne pouvez pas (ou ne voulez pas) utiliser Composer, rendez-vous dans la section Installation.

Quelque soit la manière de télécharger et installer CakePHP, une fois que la mise en place est terminée, votre dossierd’installation devrait ressembler à ceci :

/cms/bin/config/logs/plugins/src/tests/tmp/vendor/webroot.editorconfig.gitignore.htaccess.travis.ymlcomposer.jsonindex.phpphpunit.xml.distREADME.md

C’est le bon moment pour en apprendre d’avantage sur le fonctionnement de la structure des dossiers de CakePHP :rendez-vous dans la section Structure du dossier de CakePHP pour en savoir plus.

Vérifier l’installation

Il est possible de vérifier que l’installation est terminée en vous rendant sur la page d’accueil. Avant de faire ça, vousallez devoir lancer le serveur de développement :

cd /path/to/our/app

bin/cake server

19. https://getcomposer.org/download/20. https://getcomposer.org/Composer-Setup.exe

12 Chapitre 2. Guide de Démarrage Rapide

https://getcomposer.org/download/https://getcomposer.org/Composer-Setup.exe


Note : Pour Windows, la commande doit être bin\cake server (notez le backslash).

Cela démarrera le serveur embarqué de PHP sur le port 8765. Ouvrez http ://localhost :8765 dans votre navigateurpour voir la page d’accueil. Tous les éléments de la liste devront être validés sauf le point indiquant si CakePHP arriveà se connecter à la base de données. Si d’autres points ne sont pas validés, vous avez peut-être besoin d’installer desextensions PHP supplémentaires ou définir les bonnes permissions sur certains dossiers.

Ensuite, nous allons créer notre base de données et créer notre premier model.

Tutoriel CMS - Création de la base de données

Maintenant que CakePHP est installé, il est temps d’installer la base de données pour notre application CMS. Si vousne l’avez pas encore fait, créez une base de données vide qui servira pour ce tutoriel, avec le nom de votre choix (parexemple cake_cms). Exécutez ensuite la requête suivante pour créer les premières tables nécessaires au tutoriel :

USE cake_cms;

CREATE TABLE users (id INT AUTO_INCREMENT PRIMARY KEY,email VARCHAR(255) NOT NULL,password VARCHAR(255) NOT NULL,created DATETIME,modified DATETIME

);

CREATE TABLE articles (id INT AUTO_INCREMENT PRIMARY KEY,user_id INT NOT NULL,title VARCHAR(255) NOT NULL,slug VARCHAR(191) NOT NULL,body TEXT,published BOOLEAN DEFAULT FALSE,created DATETIME,modified DATETIME,UNIQUE KEY (slug),FOREIGN KEY user_key (user_id) REFERENCES users(id)

) CHARSET=utf8mb4;

CREATE TABLE tags (id INT AUTO_INCREMENT PRIMARY KEY,title VARCHAR(191),created DATETIME,modified DATETIME,UNIQUE KEY (title)

) CHARSET=utf8mb4;

CREATE TABLE articles_tags (article_id INT NOT NULL,tag_id INT NOT NULL,PRIMARY KEY (article_id, tag_id),FOREIGN KEY tag_key(tag_id) REFERENCES tags(id),FOREIGN KEY article_key(article_id) REFERENCES articles(id)

);

(suite sur la page suivante)

Tutoriel CMS - Création de la base de données 13


(suite de la page précédente)

INSERT INTO users (email, password, created, modified)VALUES('[email protected]', 'secret', NOW(), NOW());

INSERT INTO articles (user_id, title, slug, body, published, created, modified)VALUES(1, 'First Post', 'first-post', 'This is the first post.', 1, now(), now());

Vous avez peut-être remarqué que la table articles_tags utilise une clé primaire composée. CakePHP supporteles clés primaires composées presque partout, vous permettant d’avoir des shémas plus simples qui ne nécessitent pasde colonnes id supplémentaires.

Les noms de tables et de colonnes utilisés ne sont pas arbitraires. En utilisant les conventions de nommages de Ca-kePHP, nous allons bénéficier des avantages de CakePHP de manière plus efficace et allons éviter d’avoir trop deconfiguration à effectuer. Bien que CakePHP soit assez flexible pour supporter presque n’importe quel schéma de basede données, adhérer aux conventions va vous faire gagner du temps.

Configuration de la base de données

Ensuite, disons à CakePHP où est notre base de données et comment nous y connecter. Remplacer les valeurs dansle tableau Datasources.default de votre fichier config/app.php avec celle de votre installation de base dedonnées. Un exemple de configuration complétée ressemblera à ceci :


tion. Les models sont les fondations nécessaires pour construire nos actions de controllers et nos templates.

Les models de CakePHP sont composés d’objets Table et Entity. Les objets Table nous permettent d’accéder auxcollections d’entities stockées dans une table spécifique. Ils sont stockés dans le dossier src/Model/Table. Le fichierque nous allons créer sera sauvegardé dans src/Model/Table/ArticlesTable.php. Le fichier devra contenir ceci :


Tutoriel CMS - Création du Controller Articles

Maintenant que notre model est créé, nous avons besoin d’un controller pour nos articles. Dans CakePHP, les control-lers se chargent de gérer les requêtes HTTP et exécutent la logique métier des méthodes des models pour préparerune réponse. Nous placerons le code de ce controller dans un nouveau fichier ArticlesController.php, dans le dossiersrc/Controller. La base du controller ressemblera à ceci :


Les templates de view de CakePHP sont des morceaux de PHP qui sont insérés dans le layout de votre application.Bien que nous créerons du HTML ici, les Views peuvent générer du JSON, du CSV ou même des fichiers binairescomme des PDFs.

Un layout est le code de présentation qui englobe la view d’une action. Les fichiers de layout contiennent les élémentscommuns comme les headers, les footers et les éléments de navigation. Votre application peut très bien avoir plusieurslayouts et vous pouvez passer de l’un à l’autre. Mais pour le moment, utilisons seulement le layout par défaut.

Les fichiers de template de CakePHP sont stockés dans src/Template et dans un dossier au nom du controller auquelils sont attachés. Nous devons donc créer un dossier nommé “Articles” dans notre cas. Ajouter le code suivant dans cefichier :

Articles

TitreCréé le

Dans la précédente section, nous avons assigné la variable “articles” à la view en utilisant la méthode set(). Lesvariables passées à la view sont disponibles dans les templates de view comme des « variables locales », comme nousl’avons fait ci-dessus.

Vous avez peut-être remarqué que nous utilisons un objet appelé $this->Html. C’est une instance du HtmlHelper.CakePHP inclut plusieurs helpers de view qui rendent les tâches comme créer des liens, des formulaires et des élémentsde paginations très faciles. Vous pouvez en apprendre plus à propos des Helpers (Assistants) dans le chapitre de ladocumentation qui leur est consacré, mais le plus important ici est la méthode link(), qui générera un lien HTMLavec le texte fourni (le premier paramètre) et l’URL (le second paramètre).

Quand vous spécifiez des URLs dans CakePHP, il est recommandé d’utiliser des tableaux ou des routes nommées. Cessyntaxes vous permettent de bénéficier du reverse routing fourni par CakePHP.

A partir de maintenant, si vous accédez à http ://localhost :8765/articles/index, vous devriez voir votre view qui listeles articles avec leur titre et leur lien.

Création de l’action View

Si vous cliquez sur le lien d’un article dans la page qui liste nos articles, vous tombez sur une page d’erreur vousindiquant que l’action n’a pas été implémentée. Vous pouvez corrigez cette erreur en créant l’action manquante cor-respondante :

Tutoriel CMS - Création du Controller Articles 17


// Ajouter au fichier existant src/Controller/ArticlesController.php

public function view($slug = null){

$article = $this->Articles->findBySlug($slug)->firstOrFail();$this->set(compact('article'));

}

Bien que cette action soit simple, nous avons utilisez quelques-unes des fonctionnalités de CakePHP. Nous com-mençons par utiliser la méthode findBySlug() qui est un finder dynamique. Cette méthode nous permet de créerune requête basique qui permet de récupérer des articles par un « slug » donné. Nous utilisons ensuite la méthodefirstOrFail() qui nous permet de récupérer le premier enregistrement ou lancera une NotFoundExceptionsi aucun article correspondant n’est trouvé.

Notre action attend un paramètre $slug, mais d’où vient-il ? Si un utilisateur requête /articles/view/first-post, alors la valeur “first-post” sera passé à $slug par la couche de routing et de dispatching de CakePHP.Si nous rechargeons notre navigateur, nous aurons une nouvelle erreur, nous indiquant qu’il manque un template deView.

Création du template View

Créons le template de view pour notre action « view » dans src/Template/Articles/view.ctp.

Créé le :

Vous pouvez vérifier que tout fonctionne en essayant de cliquer sur un lien de /articles/index ou en vousrendant manuellement sur une URL de la forme /articles/view/first-post.

Ajouter des articles

Maintenant que les views de lecture ont été créées, il est temps de rendre possible la création d’articles. Commencezpar créer une action add() dans le ArticlesController. Notre controller doit maintenant ressembler à ceci :

// src/Controller/ArticlesController.php

namespace App\Controller;

use App\Controller\AppController;

class ArticlesController extends AppController{

public function initialize(){

parent::initialize();

$this->loadComponent('Paginator');$this->loadComponent('Flash'); // Inclusion du FlashComponent

}





public function index(){

$articles = $this->Paginator->paginate($this->Articles->find());$this->set(compact('articles'));

}

public function view($slug){

$article = $this->Articles->findBySlug($slug)->firstOrFail();$this->set(compact('article'));

}

public function add(){

$article = $this->Articles->newEntity();if ($this->request->is('post')) {

$article = $this->Articles->patchEntity($article, $this->request->→˓getData());

// L'écriture de 'user_id' en dur est temporaire et// sera supprimé quand nous aurons mis en place l'authentification.$article->user_id = 1;

if ($this->Articles->save($article)) {$this->Flash->success(__('Votre article a été sauvegardé.'));return $this->redirect(['action' => 'index']);

}$this->Flash->error(__('Impossible d\'ajouter votre article.'));

}$this->set('article', $article);

}}

Note : Vous devez inclure le FlashComponent dans tous les controllers où vous avez besoin de l’utiliser. Il est souventconseillé de le charger directement dans le AppController.

Voici ce que l’action add() fait :— Si la méthode HTTP de la requête est un POST, cela tentera de sauvegarder les données en utilisant le model

Articles.— Si pour une quelconque raison la sauvegarde ne se fait pas, cela rendra juste la view. Cela nous donne ainsi une

chance de montrer les erreurs de validation ou d’autres messages à l’utilisateur.Toutes les requêtes de CakePHP incluent un objet request qui est accessible via $this->request. L’ob-jet request contient des informations à propos de la requête qui vient d’être reçue. Nous utilisons la méthodeCake\Http\ServerRequest::is() pour vérifier que la requête possède bien le verbe HTTP POST.

Les données passées en POST sont disponibles dans $this->request->getData(). Vous pouvez utiliser lesfonctions pr() ou debug() pour afficher les données si vous voulez voir à quoi elles ressemblent. Pour sauvegarderles données, nous devons tout d’abord « marshaller » les données du POST en une Entity Article. L’Entity sera ensuitepersistée en utilisant la classe ArticlesTable que nous avons créée plus tôt.

Après la sauvegarde de notre article, nous utilisons la méthode success() du FlashComponent pour définir le mes-sage en Session. La méthode success est fournie via les méthodes magiquesde PHP 21. Les messages Flash seront

21. http://php.net/manual/en/language.oop5.overloading.php#object.call


http://php.net/manual/en/language.oop5.overloading.php#object.call


affichés sur la page suivante après redirection. Dans notre layout, nous avons qui affichera un message Flash et le supprimera du stockage de Session. Enfin, après la sauvegarde, nousutilisons Cake\Controller\Controller::redirect pour renvoyer l’utilisateur à la liste des articles.Le paramètre ['action' => 'index'] correspond à l’URL /articles, c’est-à-dire l’action index duArticlesController. Vous pouvez vous référer à la méthode Cake\Routing\Router::url() dans ladocumentation API 22 pour voir les formats dans lesquels vous pouvez spécifier une URL.

Création du Template Add

Voici le code de notre template de la view « add » :

Ajouter un article

Nous utilisons le FormHelper pour générer l’ouverture du form HTML. Voici le HTML que$this->Form->create() génère :

Puisque nous appelons create() sans passer d’option URL, le FormHelper va partir du principe que le formulairedoit être soumis sur l’action courante.

La méthode $this->Form->control() est utilisée pour créer un élément de formulaire du même nom. Lepremier paramètre indique à CakePHP à quel champ il correspond et le second paramètre vous permet de définir untrès grand nombre d’options - dans notre cas, le nombre de lignes (rows) pour le textarea. Il y a un peu d’instrospectionet de conventions utilisées ici. La méthode control() affichera des éléments de formulaire différents en fonction duchamp du model spécifié et utilisera une inflection automatique pour définir le label associé. Vous pouvez personnaliserle label, les inputs ou tout autre aspect du formulaire en utilisant les options. La méthode $this->Form->end()ferme le formulaire.

Retournons à notre template src/Template/Articles/index.ctp pour ajouter un lien « Ajouter un article ». Avant le, ajoutons la ligne suivante :

Ajout de la génération de slug

Si nous sauvons un article tout de suite, la sauvegarde échouerait car nous ne créons pas l’attribut « slug » et la colonnecorrespondante est définie comme NOT NULL. Un slug est généralement une version « URL compatible » du titre d’unarticle. Nous pouvons utiliser le callback beforeSave() de l’ORM pour créer notre slug :

// dans src/Model/Table/ArticlesTable.php

// Ajoutez ce "use" juste sous la déclaration du namespace


22. https://api.cakephp.org


https://api.cakephp.org



// pour importer la classe Textuse Cake\Utility\Text;

// Ajouter la méthode suivante

public function beforeSave($event, $entity, $options){

if ($entity->isNew() && !$entity->slug) {$sluggedTitle = Text::slug($entity->title);// On ne garde que le nombre de caractère correspondant à la longueur// maximum définie dans notre schéma$entity->slug = substr($sluggedTitle, 0, 191);

}}

Ce code est simple et ne prend pas en compte les potentiels doublons de slug. Mais nous nous occuperons de ceci plustard.

Ajout de l’action Edit

Notre application peut maintenant sauvegarder des articles, mais nous ne pouvons pas modifier les articles existants.Ajoutez l’action suivante dans votre ArticlesController :

// dans src/Controller/ArticlesController.php

// Ajouter la méthode suivante.

public function edit($slug){

$article = $this->Articles->findBySlug($slug)->firstOrFail();if ($this->request->is(['post', 'put'])) {

$this->Articles->patchEntity($article, $this->request->getData());if ($this->Articles->save($article)) {

$this->Flash->success(__('Votre article a été mis à jour.'));return $this->redirect(['action' => 'index']);

}$this->Flash->error(__('Impossible de mettre à jour l\'article.'));

}

$this->set('article', $article);}

Cette action va d’abord s’assurer que l’utilisateur essaie d’accéder à un enregistrement existant. Si vous n’avez paspassé de paramètre $slug ou que l’article n’existe pas, une NotFoundException sera lancée et le ErrorHandlerrendra la page d’erreur appropriée.

Ensuite l’action va vérifier si la requête est une requête POST ou PUT. Si c’est le cas, nous utiliserons alors les donnéesdu POST/PUT pour mettre à jour l’entity de l’article en utilisant la méthode patchEntity(). Enfin, nous appelonsla méthode save(), nous définissons un message Flash approprié et soit nous redirigeons, soit nous affichons leserreurs de validation en fonction du résultat de l’opération de sauvegarde.

Création du template Edit

Le template edit devra ressembler à ceci :



Modifier un article

Ce template affiche le formulaire de modification (avec les valeurs déjà remplies), ainsi que les messages d’erreurs devalidation.

Vous pouvez maintenant mettre à jour notre view index avec les liens pour modifier les articles :

Articles

TitreCréé leAction

Mise à jour des règles de validation pour les Articles

Jusqu’à maintenant, nos Articles n’avaient aucune validation de données. Occupons-nous de ça en utilisant un valida-tor :

// src/Model/Table/ArticlesTable.php

// Ajouter ce "use" juste sous la déclaration du namespace pour importer





// la classe Validatoruse Cake\Validation\Validator;

// Ajouter la méthode suivante.public function validationDefault(Validator $validator){

$validator->notEmpty('title')->minLength('title', 10)->maxLength('title', 255)

->notEmpty('body')->minLength('body', 10);

return $validator;}

La méthode validationDefault() indique à CakePHP comment valider les données quand la méthode save()est appelée. Ici, il est spécifié que les champs title et body ne peuvent pas être vides et qu’ils ont aussi des contraintessur la taille.

Le moteur de validation de CakePHP est à la fois puissant et flexible. Il vous fournit un jeu de règles sur des validationscommunes comme les adresses emails, les adresses IP, etc. mais aussi la flexibilité d’ajouter vos propres règles devalidation. Pour plus d’informations, rendez-vous dans la section Validation de la documentation.

Maintenant que nos règles de validation sont en place, utilisons l’application et essayons d’ajouter un ar-ticle avec un title ou un body vide pour voir ce qu’il se passe. Puisque nous avons utiliser la méthodeCake\View\Helper\FormHelper::control() du FormHelper pour créer les éléments de formulaire, nosmessages d’erreurs de validation seront affichés automatiquement.

Ajout de l’Action de Suppression

Donnons maintenant la possibilité à nos utilisateurs de supprimer des articles. Commencez par créer une actiondelete() dans ArticlesController :

// src/Controller/ArticlesController.php

public function delete($slug){

$this->request->allowMethod(['post', 'delete']);

$article = $this->Articles->findBySlug($slug)->firstOrFail();if ($this->Articles->delete($article)) {

$this->Flash->success(__('L\'article {0} a été supprimé.', $article->title));return $this->redirect(['action' => 'index']);

}}

Ce code va supprimer l’article ayant le slug $slug et utilisera la méthode $this->Flash->success() pourafficher un message de confirmation à l’utilisateur après l’avoir redirigé sur /articles. Si l’utilisateur essaie d’allersupprimer un article avec une requête GET, la méthode allowMethod() lancera une exception. Les exceptionsnon capturées sont récupérées par le gestionnaire d’exception de CakePHP qui affichera une belle page d’erreur. Ilexiste plusieurs Exceptions intégrées qui peuvent être utilisées pour remonter les différentes erreurs HTTP que votreapplication aurait besoin de générer.



Avertissement : Permettre de supprimer des données via des requêtes GET est très dangereux, car il estpossible que des crawlers suppriment accidentellement du contenu. C’est pourquoi nous utilisons la méthodeallowMethod() dans notre controller.

Puisque nous exécutons seulement de la logique et redirigeons directement sur une autre action, cette action n’a pasde template. Vous devez ensuite mettre à jour votre template index pour ajouter les liens qui permettront de supprimerles articles :

Articles

TitreCréé leAction

Utiliser View\Helper\FormHelper::postLink() va créer un lien qui utilisera du JavaScript pour faire unerequête POST et supprimer notre article.

Note : Ce code de view utilise également le FormHelper pour afficher à l’utilisateur une boîte de dialogue deconfirmation en JavaScript avant la suppression effective de l’article.

Maintenant que nous avons un minimum de gestion sur nos articles, il est temps de créer des actions basiques pournos tables Tags et Users.


CHAPITRE 3

3.0 Guide de Migration

Cette page résume les changements de CakePHP 2.x qui aidera à la migration d’un projet vers la version 3.0, ainsiqu’une référence pour être à jour des changements faits dans le cœur depuis la branche CakePHP 2.x. Assurez-vousde bien lire les autres pages de ce guide pour toutes les nouvelles fonctionnalités et les changements de l’API.

Prérequis

— CakePHP 3.x a besoin de la Version 5.4.16 ou supérieur de PHP.— CakePHP 3.x a besoin de l’extension mbstring.— CakePHP 3.x a besoin de l’extension intl.

Avertissement : CakePHP 3.0 ne fonctionnera pas si vous n’avez pas les prérequis ci-dessus.

Outil d’Upgrade

Alors que ce document couvre tous les changements non rétro-compatibles et les évolutions faites dans CakePHP3.0, nous avons également créé une application de console pour vous aider à réaliser quelques changements quiconsomment du temps. Vous pouvez Récupérer l’outil d’upgrade depuis Github 23.

23. https://github.com/cakephp/upgrade

25

https://github.com/cakephp/upgrade


Organisation des Répertoires de l’Application

L’organisation des répertoires de l’application a changé et suit maintenant PSR-4 24. Vous devez utiliser le projet desquelette d’application 25 comme point de référence lors de la mise à jour de votre application.

CakePHP doit être installé avec Composer

Puisque CakePHP ne peut plus être installé via PEAR, ou dans un répertoi

CakePHP Cookbook Documentation · Créer vos Propres Exceptions dans votre Application. . . . . . ....

Documents

Transcript of CakePHP Cookbook Documentation · Créer vos Propres Exceptions dans votre Application. . . . . . ....