This document is for CakePHP's development version, which can be significantly different
from previous releases.
You may want to read
current stable release documentation instead.
Contenu¶
Préface
- CakePHP en un Coup d’Oeil
- Conventions plutôt que Configuration
- La Couche Model (Modèle)
- La Couche View (Vue)
- La Couche Controller (Contrôleur)
- Cycle de Requête CakePHP
- Que le Début
- Lectures Complémentaires
- Où obtenir de l’aide
- Conventions de CakePHP
- Structure du dossier de CakePHP
- Guide de Démarrage Rapide
- Tutoriel d’un système de gestion de contenu
- Tutoriel CMS - Création de la base de données
- Tutoriel CMS - Création du Controller Articles
- Création du Template de liste des Articles
- Création de l’action View
- Création du Template View
- Ajouter des articles
- Création du Template Add
- Ajout de la génération de slug
- Ajout de l’action Edit
- Création du Template Edit
- Mise à jour des règles de validation pour les Articles
- Ajout de l’Action de Suppression
- Guides de Migration
- Guide de mise à jour pour la version 4.0
- Guide de migration vers la version 4.0
- Guide de migration vers la version 4.1
- Guide de migration vers la version 4.2
- Guide de migration vers la version 4.3
- Guide de migration vers la version 4.4
- Tutoriels et exemples
- Tutoriel d’un système de gestion de contenu
- Tutoriel CMS - Création de la base de données
- Tutoriel CMS - Création du Controller Articles
- Création du Template de liste des Articles
- Création de l’action View
- Création du Template View
- Ajouter des articles
- Création du Template Add
- Ajout de la génération de slug
- Ajout de l’action Edit
- Création du Template Edit
- Mise à jour des règles de validation pour les Articles
- Ajout de l’Action de Suppression
- Tutoriel CMS - Tags et Users
- Tutoriel CMS - Authentification
- Tutoriel CMS - Autorisation
- Contribuer
- Documentation
- Tickets
- Code
- Normes de codes
- Ajout de Nouvelles Fonctionnalités
- Configuration de l’IDE
- Indentation
- Longueur des lignes
- Structures de Contrôle
- Comparaison
- Appels des Fonctions
- Définition des Méthodes
- Chaînage des Méthodes
- Commenter le Code
- Inclure les Fichiers
- Les Balises PHP
- Convention de Nommage
- Attention quand vous utilisez empty()/isset()
- Guide de Compatibilité Rétroactive
- Mises à jour
Pour Commencer
- Installation
- Configuration
- Application
- Injection de Dépendance
- Routing
- Tour Rapide
- Connecter les Routes
- Les Eléments de Route
- Eléments de Routes réservés
- Configurer les Options de Route
- Passer des Paramètres à l’Action
- Utilisation du Routage de Chemin
- Utiliser les Routes Nommées
- Prefix de Routage
- Création de liens vers des routes de préfixe
- Routing des Plugins
- Créer des Liens vers des Routes de Plugins
- Routing Favorisant le SEO
- Matching des Méthodes HTTP Spécifiques
- Matching de Noms de Domaine Spécifiques
- Routing des Extensions de Fichier
- Middleware appliqué à une Route
- Grouper les Middlewares
- Créer des Routes RESTful
- Créer des Routes de Ressources Imbriquées
- Limiter la Création des Routes
- Changer les Actions du Controller
- Mapper des Routes de Ressource Supplémentaires
- Router vers une Ressource Préfixée
- Classes de Route Personnalisée pour les Ressources
- Inflection de l’URL pour les Routes Ressource
- Changer le chemin d’un élément
- Arguments Passés
- Générer des URLs
- Générer des URL de ressources
- Routing de Redirection
- Routage des Entités
- Classes Route Personnalisées
- Créer des Paramètres d’URL Persistants
- Les Objets Request & Response
- ServerRequest
- Paramètres de la Requête
- Accéder aux Paramètres Querystring
- Données du Corps de la Requête
- Envoyer des fichiers
- Accéder aux Données PUT, PATCH ou DELETE
- Variables d’Environnement (à partir de $_SERVER et $_ENV)
- Données XML ou JSON
- Informations du Chemin
- Vérifier les Conditions de la Requête
- Données de Session
- Hôte et Nom de Domaine
- Lire la Méthode HTTP
- Restreindre les Méthodes HTTP qu’une Action Accepte
- Lire les en-têtes HTTP
- Faire Confiance aux Headers de Proxy
- Vérifier les En-têtes Acceptés
- Lire des Cookies
- Fichiers uploadés
- Manipuler les URIs
- Response
- Définir les En-têtes de Requête d’Origine Croisée (Cross Origin Request Headers = CORS)
- Erreurs Communes avec les Responses Immutables
- CookieCollections
- ServerRequest
- Middleware
- Controllers (Contrôleurs)
- Le Controller App
- Déroulement d’une Requête
- Les Actions du Controller
- Interactions avec les Vues
- Négociation de Contenu
- Rediriger vers d’Autres Pages
- Chargement des Modèles Supplémentaires
- Paginer un Modèle
- Configurer les Components à Charger
- Cycle de Vie des Callbacks de la Requête
- Middleware de Controller
- Plus sur les Controllers
- Le Controller Pages
- Components (Composants)
- Authentification
- Lectures Suggérées Avant de Continuer
- Authentification
- Choisir un Type d’Authentification
- Configuration des Gestionnaires d’Authentification
- Personnaliser la Requête de Recherche
- Identifier les Utilisateurs et les Connecter
- Rediriger les Utilisateurs Après Connexion
- Création de Systèmes d’Authentification Stateless
- Utiliser l’Authentification Basic
- Utiliser l’Authentification Digest
- Créer des Objets d’Authentification Personnalisés
- Utilisation d’Objets d’Authentification Personnalisés
- Gestion des Requêtes non Authentifiées
- Afficher les Messages Flash de Auth
- Hachage des Mots de Passe
- Créer des Classes de Hash de Mot de Passe Personnalisé
- Changer les Algorithmes de Hashage
- Connecter les Utilisateurs Manuellement
- Accéder à l’Utilisateur Connecté
- Déconnexion des Utilisateurs
- Décider quand lancer l’Authentification
- Autorisation
- Options de Configuration
- Tester des Actions Protégées par AuthComponent
- Flash
- SecurityComponent (Sécurité)
- Pagination
- Request Handling (Gestion des requêtes)
- Protection de Formulaire
- Checking HTTP Cache
- Configuration des Components
- Utiliser les Components
- Créer un Component
- Callbacks des Components
- Utiliser des Redirections dans les Events des Components
- Authentification
- Views (Vues)
- La View App
- Templates de Vues
- Utiliser les Blocks de Vues
- Layouts
- Elements
- Events de View
- Créer vos propres Classes de View
- En savoir plus sur les vues
- View Cells
- Themes
- Vues JSON et XML
- Helpers (Assistants)
- Breadcrumbs
- Flash
- Form
- Création de Formulaire
- Création d’éléments de Formulaire
- Générer des Types d’Inputs Spécifiques
- Créer des Éléments Input
- Créer les Labels
- Afficher et vérifier les erreurs
- Création des boutons et des éléments submit
- Fermer le Formulaire
- Créer des Boutons Indépendants et des liens POST
- Personnaliser les Templates Utilisés par FormHelper
- Générer des Formulaires Entiers
- Créer des Inputs pour les Données Associées
- Ajouter des Widgets Personnalisés
- Travailler avec SecurityComponent
- Html
- Insertion d’éléments correctement formatés
- Créer un Tag Charset
- Lier des Fichiers CSS
- Créer des CSS par Programmation
- Créer des Balises meta
- Créer le DOCTYPE
- Lier des Images
- Créer des Liens
- Liens vers des Videos et Fichiers Audio
- Lier des Fichiers Javascript
- Créer des Blocs Javascript Inline
- Créer des Listes Imbriquées
- Créer des En-Têtes de Tableaux
- Créer des Cellules de Tableaux
- Changer l’affichage des balises avec le Helper Html
- Création d’un chemin de navigation avec le Helper Html
- Insertion d’éléments correctement formatés
- Number
- Paginator
- Templates de PaginatorHelper
- Création de liens de tri
- Création des liens de page numérotés
- Création de liens de sauts
- Créer des Liens de Header
- Vérifier l’Etat de la Pagination
- Création d’un compteur de page
- Générer des Url de Pagination
- Créer une Liste Déroulante de Limites
- Configurer les Options de Pagination
- Exemple d’Utilisation
- Paginer Plusieurs Résultats
- Text
- Time
- Url
- Configurer les Helpers
- Utiliser les Helpers
- Méthodes de Callback
- Créer des Helpers
- Classe Helper
- Accès Base de Données & ORM
- Exemple Rapide
- Pour en savoir plus
- Notions de Base de Base de Données
- Query Builder
- Les Objets Table
- Entities
- Créer des Classes Entity
- Créer des Entities
- Accéder aux Données de l’Entity
- Accesseurs & Mutateurs
- Vérifier si une Entity a été Modifiée
- Erreurs de Validation
- Assignement de Masse
- Lazy Loading des Associations
- Créer du Code Réutilisable avec les Traits
- Convertir en Tableaux/JSON
- Stocker des Types Complexes
- Récupérer les Données et les Ensembles de Résultats
- Déboguer les Queries et les ResultSets
- Récupérer une Entity Unique avec une Clé Primaire
- Utiliser les Finders pour Charger les Données
- Récupérer les Premiers Résultats
- Récupérer un Nombre de Résultats
- Trouver les Paires de Clé/Valeur
- Trouver des Données Filées
- Méthodes Finder Personnalisées
- Finders Dynamiques
- Récupérer les Données Associées
- Eager Loading des Associations Via Contain
- Filtrer par les Données Associées Via Matching et Joins
- Changer les Stratégies de Récupération
- Lazy loading des Associations
- Travailler sur les Résultats (Result Sets)
- Modifier les Résultats avec Map/Reduce
- Valider des Données
- Valider les Données Avant de Construire les Entities
- Utiliser un Ensemble de Validation Différent pour les Associations
- Créer un Vérificateur de Règles
- Créer des Règles d’Unicité de Champ
- Règles de Clés Etrangères
- Règles sur le Nombre de Valeurs d’une Association
- Règles de Contraintes d’Association
- Utiliser les Méthodes d’Entity en tant que Règles
- Utiliser des Règles Conditionnelles
- Messages d’Erreur Dynamiques/Conditionnels
- Créer des Règles Personnalisées Réutilisables
- Créer des Objets de Règles Personnalisées
- Désactiver les Règles
- Utiliser la Validation en tant que Règle d’Application
- Sauvegarder les Données
- Coup d’Oeil sur l’Enregistrement des Données
- Convertir les Données Requêtées en Entities
- Convertir des Données BelongsToMany
- Convertir des Données HasMany
- Convertir des Enregistrements Multiples
- Changer les Champs Accessibles
- Fusionner les Données de la Requête dans les Entities
- Modifier les Données de la Requête Avant de Construire les Entities
- Modifier les Entités Après leur Mise À Jour À Partir de la Requête
- Valider les Données Avant de Construire les Entities
- Éviter les Attaques d’Assignement en Masse de Propriétés
- Sauvegarder les Entities
- Strict Saving
- Trouver Ou Créer une Entity
- Créer Avec une Clé Primaire
- Sauvegarder Plusieurs Entities
- Mises à Jour en Masse
- Supprimer des Données
- Associations - Lier les Tables Ensemble
- Behaviors (Comportements)
- Utiliser les Behaviors
- Behaviors du Cœur
- Créer un Behavior
- Transformer les Données de la Requête en Propriétés de l’Entity
- Retirer les Behaviors Chargés
- Accéder aux Behaviors Chargés
- Système de Schéma
- Shell du Cache du Schéma
Généralités
- La mise en cache
- Configuration de la classe Cache
- Ecrire dans un Cache
- Lire depuis un Cache
- Suppression d’un Cache
- Effacer les Données du Cache
- Utiliser le Cache pour Stocker les Compteurs
- Utiliser le Cache pour Stocker les Résultats de Requêtes Courantes
- Utilisation des Groupes
- Activer ou Désactiver Globalement le Cache
- Création d’un moteur de stockage pour le Cache
- Commandes sur la Console
- La Console CakePHP
- Applications sur Console
- Renommer des Commandes
- Commandes
- Objets Command
- Entrée/Sortie de Commande
- Helpers (Assistants) de commande
- Créer des Helpers (Assistants)
- Les Helpers inclus
- Récupérer l’entrée utilisateur
- Créer des fichiers
- Créer une sortie
- Output Levels
- Styliser la sortie
- Désactiver la Couleur
- Option Parsers
- Exécuter des Shells en Tâches Cron (Cron Jobs)
- Commandes Fournies par CakePHP
- Shell Cache
- Complétion du Shell
- Shell I18N
- Shell Plugin
- Shell du Cache du Schéma
- Shell Routes
- Serveur Shell
- Console Interactive (REPL)
- Shells
- Routage dans l’Environnement de la Console
- Debugger
- Déploiement
- Mailer
- Gestion des Erreurs & Exceptions
- Configuration des Erreurs et des Exceptions
- Modifier la gestion des exceptions
- Templates d’erreur personnalisés
- ErrorController personnalisé
- ExceptionRenderer personnalisé
- Créer vos Propres Gestionnaires d’Erreurs
- Logging Personnalisé des Erreurs
- Créer vos propres Exceptions d’Application
- Exceptions Intégrées de CakePHP
- Événements système
- Internationalisation & Localisation
- Journalisation (logging)
- Formulaires Sans Models
- Pagination
- Plugins
- Installer un Plugin Avec Composer
- Installer un Plugin Manuellement
- Charger un Plugin
- Configuration du Plugin
- Utiliser un Plugin
- Créer Vos Propres Plugins
- Plugin Classes
- Routes de Plugins
- Controllers du Plugin
- Models du Plugin
- Vues du Plugin
- Ressources de Plugin
- Components, Helpers et Behaviors
- Commands
- Tester votre Plugin
- Publier votre Plugin
- Fichier de Mappage de Plugin
- Gérer Vos Plugins avec Mixer
- REST
- Sécurité
- Sessions
- Testing
- Installer PHPUnit
- Tester la Configuration de la Base de Données
- Vérifier la Configuration Test
- Conventions des Cas de Test (TestCase)
- Créer Votre Premier Cas de Test
- Lancer les Tests
- Callbacks du Cycle de Vie des Cas de Test
- Fixtures
- Connexions de Test
- Configuration de PHPUnit
- Créer un Schéma de Base de Données de Test
- Gestionnaires d’Etat des Fixtures
- Créer les Fixtures
- Les Données Dynamiques
- Charger les Fixtures dans vos Tests
- Fixture Factories
- Charger des Routes dans les Tests
- Création de routes dans les tests
- Charger des Plugins dans les Tests
- Tester les Classes De Tables
- Tests d’Intégration des Controllers
- Configurer la Requête
- Tester Des Actions Qui Nécessitent Une Authentification
- Test de l’Authentification Stateless (sans état) et des APIs
- Tester les Actions Protégées par CsrfProtectionMiddleware ou FormProtectionComponent
- Test d’intégration sur les middlewares PSR-7
- Tester avec des Cookies Cryptés
- Tester les Messages Flash
- Tester un Controller Retournant du JSON
- Test avec Téléversement de Fichiers
- Désactiver le Middleware de Gestion d’Erreurs dans les Tests
- Méthodes d’Assertion
- Comparer les Résultats du Test avec un Fichier
- Tests d’Intégration en Console
- Mocker les Injections de Dépendances
- Mocker les Réponses du Client HTTP
- Tester les Views
- Tester les Components
- Tester les Helpers
- Tester les Events
- Testing Email
- Créer des Suites de Test (Test Suites)
- Créer des Tests pour les Plugins
- Générer des Tests avec Bake
- Validation
- Créer les Validators
- Valider la Présence d’un champ
- Permettre aux Champs d’être Vides
- Marquer les Règles comme étant les Dernières à être exécutées
- Méthodes de Validation Moins Verbeuses
- Ajouter des Providers de Validation
- Règles de Validation Personnalisées
- Validation Conditionnelle
- Imbriquer des Validators
- Créer des Validators Ré-utilisables
- Valider les Données
- Valider les Entities
- Règles de Validation du Cœur
- Créer les Validators
Utilitaires
- Classe App
- Collections
- Folder & File
- Hash
- Client Http
- Inflector
- Number
- La Classe Plugin
- Objets Registry
- Text
- Convertion des Chaînes de Caractères en ASCII
- Créer des chaînes saines pour les URL
- Générer des UUIDs
- Parseur de chaînes simples
- Formater une chaîne
- Fixer la largeur d’un texte
- Subrillance de Sous-Chaîne
- Retirer les Liens
- Tronquer le Texte
- Tronquer une chaîne par la fin
- Générer un Extrait
- Convertir un tableau sous la forme d’une phrase
- Date & Time
- Xml
Plugins & Packages
Divers
- Globales & Fonctions
- Annexes
- 4.x Guide de Migration
- Guide de migration vers la version 4.0
- Guide de migration vers la version 4.1
- Guide de migration vers la version 4.2
- Guide de migration vers la version 4.3
- Mise à Niveau des Fixtures
- Mimer la Compatibilité Descendante
- Mimer la Compatibilité Ascendante
- Informations générales
- 4.x Guide de Migration