1 / 77

CakePHP 2.x

CakePHP 2.x. CakePHP 2.x. Présentation framework et philosophie Arborescence, architecture et installation Les conventions de CakePHP Le Router La couche MVC Le pattern ActiveRecord et le CRUD de CakePHP Evénements, Collections et Objets Les exceptions Les librairies intégrées

rian
Download Presentation

CakePHP 2.x

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript


  1. CakePHP 2.x

  2. CakePHP 2.x • Présentation framework et philosophie • Arborescence, architecture et installation • Les conventions de CakePHP • Le Router • La couche MVC • Le pattern ActiveRecord et le CRUD de CakePHP • Evénements, Collections et Objets • Les exceptions • Les librairies intégrées • La Console et la Bakery • Le Scaffolding

  3. Présentation framework et philosophie • Projet initié en 2005 par Michal Tatarynowicz sous licence MIT. • Le projet a été vite repris par la « Cake Software Foundation », fondée par Larry E. Masters et Garrett J. Woodworth. Elle se compose de quelquesdevelopeurscomme Nate Abele (fondateur de Lithium, autre framework), John Anderson (fondateur du Cookbook, espace de documentation du framework) ou Mark Story (actuellement le leaddev sur le projet). • Lorsqu’on regarde les commits on constate aujourd’hui que plusieurs personnes d’origines très différentes (USA, Espagne, Japon, Pays-pays, UK, etc…) participent activement au projet sous la houlette de la « Cake Software Foundation », il s’agit donc là d’un vrai projet participatif et collaboratif organisé autour d’une même communauté. • CakeDC est l’agence fondée par Larry E. Masters, le SensioLab de CakePHP en quelquessortes.

  4. Présentation framework et philosophie • CakePHP est présenté comme l’adaptation en PHP des principes qui ont fait le succès de Ruby On Rails. • Le principal patron de conception est Modèle-Vue-Controleur c’est pourquoi on dit qu’il s’agit d’un framework MVC. • La version stable actuelle est 2.1.1. • Il est disponible sur PEAR pour les dernières versions stables ou Github pour les 13 branches en cours.

  5. Présentation framework et philosophie • CakePHP est l’expression de « convention au lieu de configuration ». • La priorité de CakePHP est le développement rapide en utilisant des paradigmes bien définis. • Dans CakePHP chaque fonctionnalité se code d’une façon particulière, le framework impose une architecture et un best practice.

  6. Arborescence, architecture et installation |-- app -> Dossier des fichiers de l'application | |-- Config -> Dossier des fichiers de configuration | | |-- Schema -> Fichiers SQL nécessaires à l'initialisation du projets | |-- Console -> Dossier des scripts console | | | |-- Command -> Dossier des commandes shell | | | `-- Task -> Dossier des commandes réutilisables | |-- Controller -> Dossier des contrôleurs | | `-- Component -> Dossier des components, librairies de factorisation de code | |-- Lib -> Dossier des librairies internes au projet | |-- Locale -> Dossier des locales pour l'internationalisation | |-- Model -> Dossier des modèles | | |-- Behavior -> Dossier des Behaviors, comportements câblés sur les événements | | | d'édition de données | | `-- Datasource -> Dossier des Datasources, Adpaters particuliers pour accéder à | | | une API par exemple | |-- Plugin -> Dossier des Plugins, sous-modules MVC | |-- Test -> Dossier des Tests, pour faire du développement piloté par les | | | tests (Avec PHPUnit) | |-- Vendor -> Dossiers des librairies extérieurs

  7. Arborescence, architecture et installation | |-- View -> Dossier des vues, pour chaque controleur un dossier de vue est | | | associé | | |-- Elements -> Dossier des Elements, sous-vues réutilisables | | |-- Emails -> Dossier déstinés aux templates d'e-mails | | | |-- html -> Cas HTML | | | `-- text -> Cas texte | | |-- Errors -> Dossiers des vues des pages d'erreur comme 404 | | |-- Helper -> Dossiers des Helpers de vue du projet, routines de rendus comme | | | le Helper de formulaires | | |-- Layouts -> Dossier des layouts, fichier de vue principal comportant | | | généralement le header et le footer | | |-- Pages -> Pages ne nécessitants pas de contrôleurs | | |-- Scaffolds -> Dossiers des Scaffolds du projet, vues génrériques pour un BO par exemple

  8. Arborescence, architecture et installation | |-- tmp -> Dossiers des fichiers temporaires | | |-- cache -> Dossier de cache | | | |-- models -> Cache de la couche modèle (de la configuration, pas des données | | | | en base), automatique en prod | | | |-- persistent -> Cache requêtes donc des données en base (modèles persistants) | | | `-- views -> Cache des vues ou de parties de vues | | |-- logs -> Dossier de logs | | |-- sessions -> Dossier contenant les sessions | | `-- tests -> Fichiers temporaires issues des tests | `-- webroot -> Document Root | |-- css -> Fichiers CSS | |-- files -> Uploads | |-- img -> Images | `-- js -> Javascripts

  9. Arborescence, architecture et installation |-- lib -> Dossier des librairies Cake | `-- Cake | |-- Cache | |-- Config | |-- Configure -> Readers de fichiers de config (PHP ou INI) | |-- Console | |-- Controller | | `-- Component | |-- Core -> Librairies les plus bas niveaux de CakePHP avec notamment App et | | Object (beaucoup de composants héritent d'Object) | |-- Error | |-- Event -> Tous les composants qui ont des callbacks comme les Contrôleurs, | | les Components ou les Behaviors implémentent une interface de | | listener d'events | |-- I18n | |-- Log | | `-- Engine

  10. Arborescence, architecture et installation | |-- Model | | |-- Behavior | | `-- Datasource -> CakePHP est livré avec un Adapter de Base de données et de | | Session | | |-- Database | | `-- Session | |-- Network | | |-- Email | | `-- Http | |-- Routing | | `-- Route | |-- Test | |-- TestSuite | |-- Utility -> Classes indépendantes utilisées dans l'ensemble des librairies de | | CakePHP | `-- View | |-- Elements | |-- Errors | |-- Helper | `-- Scaffolds |-- plugins -> Il est possible d’avoir plusieurs « app » partageant le même Core. `-- vendors Dans ce cas il est également possible d’avoir des plugins et librairies partagés entre tous les projets.

  11. Arborescence, architecture et installation Détail d’une requête CakePHP

  12. Arborescence, architecture et installation • L’installation de CakePHP est très simple, il y a plusieurs solutions. • Un .htaccess se situe à la racine de CakePHP, dans le dossier «  app » et dans le dossier « app/webroot ». • Même si la convention voudrait qu’on situe le DocumentRoot sur « app/webroot », grâces aux mutiples .htaccess il est possible de le positionner sur « app » ou même de mettre l’ensemble des fichiers de CakePHP. • Il faudra activer la réécriture d’url et le support des .htaccess (sinon ajouter dans la configuration serveur le contenu du .htaccess correspondant). • Au pire, CakePHP peut très bien fonctionner sans réécriture d’url. Dans ce cas il faut mettre le DocumentRoot sur « app/webroot » • CakePHP peut également très bien se mettre dans un dossier indépendant.

  13. Arborescence, architecture et installation Premier écran de CakePHP une fois les fichiers installés correctement

  14. Arborescence, architecture et installation • Il faut remplacer le « salt », utilisé par le hashing et le « cypherseed » utilisé pour l’encryption. Vous pouvez aller à cette adresse pour obtenir les bons codes:http://www.sethcardoza.com/tools/random_password_generator/ • Il faut ensuite configurer la base de données dans le fichier database.php. Il est possible de ne pas avoir de DB en utilisant un DataSource personnalisé qui ne pointe vers aucune base:http://bakery.cakephp.org/articles/Primordial/2012/01/19/cakephp_v2_without_a_database_fixed

  15. Les conventions de CakePHP • Les noms de fichiers et de dossier sont généralement en CamelCase sauf pour les fichiers de templates (vues). • Les classes sont en CamelCase. • Les modèles s’écrivent au singulier, il y a un modèle par table et ces dernières n’ont qu’une clé primaire (en auto-incrément généralement). • Les contrôleurs s’écrivent au pluriel. • Les actions s’écrivent en lowerCamelCase. • Les dossiers des vues on les noms des Contrôleurs, donc au pluriel. Les fichiers sont le nom des actions en minuscule traduit avec des underscores. • Les actions du back-office son précédées par « admin_ » • Les noms de tables sont en minuscule et séparés par des underscores.

  16. Le Router • La route par défaut de CakePHP est la suivante: « /controler/action/param1:test/param2:test2 ». • L’ensemble des routes se trouvent de le fichier « app/Config/routes.php ». • Toutes les routes peuvent être créés grâce à la méthode « Router::connect() ». • Le premier argument de « Router::connect() » est la chaine de la route, elle contient des clés préfixées par « : », on peut utiliser les wildcards « *  » afin que le reste de l’url soit considéré comme des paramètres de l’action. • Dans le deuxième argument on définit les clés de la route. • Dans le troisième argument on définit les options dont le format des valeurs des clés.

  17. Le Router • Les clés « controller », « action » positionnent ces deux paramètres.Elles peuvent être fixées en dur dans le deuxième argument s’ils n’apparaissent pas dans la chaine de la route. • La clé « filter » permet de définir les paramètres nommées autorisés, c’est-à-dire généralement les paramètres d’une action. • Le paramètre « admin » permet de créer des routes de Backoffice et ne prend que les actions préfixées par « admin_ ». • Il est également possible de contrôler les paramètres nommées avec « Router::connectNamed() » et d’y associer des règles comme pour les paramètres normaux.

  18. Le Router • « Router::url » permet de faire du reverse routing, c’est-à-dire regénérer l’url suivant ses composantes. • « Router::redirect » permet de mettre en place des règles de redirection. • « Router::mapResources » permet de définir un contrôleur REST. • « Router::parseExtentions » permet de définir les formats qu’accepte l’application (html, rss, json, xml, etc).

  19. Le Router – La routeClass • La routeClass, qui est définie dans les options de « Router::connect() » permet de définir une classe de routing particulière dans laquelle il sera possible de faire tous les traitements voulus. • Dans cette classe custom qui devra être insérée avant le « Router::connect() », il y a deux méthodes qui peuvent être implémentées: • « parse() » appelé lorsqu’on envoie la requête HTTP • « match() » appelé lorsqu’on fait l’inverse, c’est-à-dire qu’on recompose l’url d’après ses paramètres.

  20. La couche MVC • Dans CakePHP, bien que dans la plupart des cas un modèle, un contrôleur et une vue doivent être ajoutées, le modèle et la vue ne sont pas obligatoires. • Pour ne pas avoir de vue on ajoute «  $this->autoRender = false; » dans le contrôleur. • Pour ne pas avoir de modèle on initialise l’attribut « uses » à null dans la classe contrôleur. • On peut même avoir un modèle sans DataSource, on utilise l’attribut « useTable » qu’on initialise à false dans la classe modèle.

  21. La couche MVC – Le modèle • La classe de modèle hérite de AppModel. • Le paramètre « primaryKey » permet de définir le nom de la clé primaire de la table. • Le paramètre « validate » permet d’ajouter des validateurs sur chaque champ. • Le paramètre « hasOne » permet de définir une relation de type 1-1 -> 1-1. On y détermine notamment la clé étrangère ou les conditions de relation.A noter que si on a respecté les conventions de nommage de CakePHP pour la clé étrangère(« table-cible_id »), il suffit uniquement d’ajouter le nom de la table cible.

  22. La couche MVC – Le modèle • Le paramètre « belongsTo » permet de définir une relation de type 0-n -> 1-1. Idem à « hasOne » sauf qu’on peut définir l’ordre et la limite qui seront appliqués lors de la jointure. • Le paramètre « hasMany » permet de définir une relation de type inverse, c’est-à-dire 1-1 -> 0-n. • Le paramètre « hasAndBelonsToMany » permet de définir une relation de type 0-n -> 0-n, donc une association.Dans ce cas la configuration contient les informations de la table d’association en plus de la clés étrangère. Cela évite de faire des modèles pour des associations.

  23. La couche MVC – Le contrôleur • Tous les contrôleurs de l’application héritent de « AppConroller » qui hérite lui-même de « Controller ». • Ainsi toutes les actions, attributs, callbacks, etc. communs peuvent être mis dans « AppController ». • Les méthodes du contrôleur sont les actions, pour accéder à chaque action en passant des paramètres, il suffit d’appeler : « /controler/action/param1:test/param2:test2 » • L’objet « request » contient toutes les informations de la requête et les paramètres passés, il est obligatoire de passer par cet objet.

  24. La couche MVC – Le contrôleur • L’argument « uses » permet d’ajouter un ou plusieurs modèles ou librairies du dossier « Lib », l’argument « conponents » permet de définir les composants qui seront utilisés, idem pour l’argument « helpers » avec les helpers de vue. • Chaque contrôleur dispose de 3 callbacks: • « Controller::beforeFilter» qui est déclenché avant toute action, • «  Controller::beforeRender» qui est déclenché avant tout rendu, • « Controller::afterFilter» qui est déclenché après toute action. • La méthode « set » sert à affecter des valeurs à la vue, on lui passe soit deux arguments clé et valeur soit un tableau de clés/valeurs. • La méthode « render » permet de déclencher le rendu avec la vue passée en paramètre.Cette méthode est exécutée automatiquement avec la vue logiquement associée dans l’arborescence.

  25. La couche MVC – La vue • Il s’agit de fichier avec l’extension *.ctp • Des blocs et une hiérarchisation des vues qui en découle peuvent être définis. • Un bloc permet en d’autres termes de définir des zones d’un Layout ou la vue parente dans la vue enfant. • Les vues peuvent en étendre d’autres, par défaut les vues étendent le Layout, mais ce principe peut être appliqué à des vues grâce à la méthode « extend ». • Le principal bloc est « content », il contient tout ce qui est affiché dans la vue. • Les blocs « script » et « css » sont liés au Helper HTML et à ses méthodes. L’affectation du bloc peut être surchargée.

  26. La couche MVC – La vue • On peut définir d’autres blocs en encadrant leur code par les méthodes « start » et « end » dans la vue. • La méthode « fetch » dans la vue est un appel de bloc: • «  echo $this->fetch(‘content’); » appelle le bloc principal, • «  echo $this->fetch(‘sidebar’); » appelle un bloc sidebar défini dans la vue fille, • « echo $this->fetch(‘css’); » insère toutes les feuilles de styles ajoutées avec le Helper Html :« $this->Html->css('carousel', null, array('inline' => false)); »la dernière option spécifieque les balisesdoiventêtreajoutées au bloc du même nom, iciils’agit du bloc « css », • Il est possible d’ajouter les balises à un autre bloc:« $this->Html->script('carousel', array('block' => 'scriptBottom')); ».

  27. La couche MVC – La vue • Il est possible de définir des thèmes avec l’attribut « theme » dans le contrôleur. Les vues et les assets se trouvent donc dans un dossier correspondant au nom du thème. • Il existe des vues Media qui permettent de rendre des fichiers binaires. Cette vue sert principalement à servir des fichiers qui nécessitent une authentification ou une vérification particulière. Pour les utiliser il faut assigner le paramètre « viewClass » à « Media » dans l’action du contrôleur. • Avec la clé « _serialize » dans la méthode « set » du contrôleur, les données seront automatiquement sérialisées dans le format demandé grâce à « Router::parseExtensions() »

  28. Le pattern ActiveRecord et le CRUD de CakePHP Représentation en digramme de classe du design ActiveRecord

  29. Le pattern ActiveRecord et le CRUD de CakePHP • ActiveRecord est la représentation en classe d’une table, ses attributs sont les champs et ses méthodes permettent les différentes requêtes de sélection, d’ajout ou de suppression. • Lorsqu’on veut traiter plusieurs enregistrements, donc plusieurs instances de classes ActiveRecord, il est nécessaire d’avoir des Collections de ces instances pour pouvoir les traiter. • Il existe un lien très fort entre les données des l’objets ActiveRecord et ceux de la base, l’enregistrement, la ligne de la table est réellement un tuple, une copie de l’objet.

  30. Le pattern ActiveRecord et le CRUD de CakePHP • Le CRUD de CakePHP reprend de façon très proche le patron ActiveRecord de Ruby on Rails. • Cette implémentation diffère quelque peut du design pattern initial présenté précédemment. • Pour éviter de gérer des collections et des instanciations issues des tuples de la table, la couche modèle contient des assesseurs qui vont retourner des tableaux simples. • Il est d’ailleurs possible d’utiliser les assesseurs sans ActiveRecord, c’est-à-dire sans que les données soient représentées dans la classe.

  31. Le pattern ActiveRecord et le CRUD de CakePHP • Les méthodes « set », « read » et « create » permettent cependant de faire de l’ActiveRecord, « read » permet de charger un enregistrement depuis la base dans l’objet Modèle et « set » depuis le contrôleur. Si un « save » sans paramètres est fait ensuite, les données ajoutées dans l’objet seront utilisées pour faire l’INSERT ou l’UPDATE. « create » permet de réinitialiser les données de l’objet. • L’ActiveRecord dans CakePHP ne concerne que les enregistrements uniques car les modèles sont des Singletons et sert surtout lors de l’enregistrement des données.

  32. Le pattern ActiveRecord et le CRUD de CakePHP - Find • La méthode « find » permet de rechercher des enregistrements sans ActiveRecord: • « find(‘first’) récupère le premier enregistrement, • « find(‘count’) récupère le nombre de lignes, • « find(‘all’) récupère tous les enregistrements, • « find(‘list’) récupère tous les enregistrements sous forme de tableaux simple dont les index sont les id, • « find(‘threaded’) » récupère tous les enregistrements sous forme de tableaux imbriqués, dans les clés « children » se trouvent les données enfants, utile pour les catégories hiérarchisées par exemple. • « find(‘neighbors’) » récupère l’enregistrement précédent et suivant du first, pratique pour les pagers next/prev.

  33. Le pattern ActiveRecord et le CRUD de CakePHP - Find • Le deuxième paramètre, la « query », permet d’ajouter: • les champs qui seront sélectionnés, • les conditions, • la récursivité; il s’agit de prendre les n tables associées. Pour ne prendre que les données de la table la récursivité à valeur « -1 », pour prendre le premier niveau de tables liées, elle aura la valeur « 0 », etc. • On peut également utiliser les « MagicFind Types ». Ils vont vous permettre de rechercher par un ou plusieurs champs directement depuis l’appel de la méthode. Par exemple la méthode « findAllByLastName(‘jack’) » va nous permettre de chercher tous les enregistrement avec les champs « last_name » « jack ». Il est possible de chercher sur plusieurs champs avec les opérateurs « Or » ou « And ».

  34. Le pattern ActiveRecord et le CRUD de CakePHP - Find • Il est possible de faire ses propres « find », tout simplement en ajoutant des méthodes dans l’attribut « findMethods » du modèle et de définir la méthode: « protected_findMaMethode($state, $query, $result) ».Les arguments sont: • « state », « before » ou « after », définit si le traitement concerne la « query » ou le « result ». Dans le premier cas on retourne la « query » et elle est éxécutée, dans le second on retourne le « result », • « query » est la requête demandée, le deuxième paramètre du find, • « result » est le résultat de la requête.

  35. Le pattern ActiveRecord et le CRUD de CakePHP - Save • Avec le fonction d’enregistrement on peut tirer partie de l’ActiveRecord avec « set() », « read() » et « create() ». • Si on initialise l’attribut « id » et qu’un save est ensuite exécuté alors il s’agira d’un UPDATE. On remarque ici que le mécanisme offert par ActiveRecord est plutôt pratique. • La méthode « save() » prend en premier paramètre le tableau de données à sauvegarder, si celui est null alors « save() » rentrera dans un fonctionnement ActiveRecord.

  36. Le pattern ActiveRecord et le CRUD de CakePHP - Save • Voici les autres méthodes d’enregistrement: • « saveField() », enregistre uniquement un champ, il faut initialiser l’id avant de lancer cette méthode, • « updateAll() », enregistre plusieurs enregistrements en fonction des conditions passées dans le 2ème paramètre, • « saveMany() », enregistre plusieurs lignes en même temps, il est possible d’activer les transactions avec «  atomic » et/ou enregistrer les données associées avec « deep », des options qui peuvent être ajoutées en 2ème paramètre, • « saveAssociated() », enregistre l’ensemble des données imbriquées, la méthode dispose des même options que saveMany() mais son option « deep » est plus forte car elle peut enregistrer toutes les données imbriquées et pas seulement les données associées, • « saveAll() » est un Wrapper de « saveMany() » et « saveAssociated() ».

  37. Le pattern ActiveRecord et le CRUD de CakePHP - Delete • La méthode « delete() » va supprimer l’enregistrement ayant l’id précisé en premier argument. « delete() » fonctionne également en ActiveRecord et peut supprimer la donnée active si on ne lui précise pas de paramètre.Le 2ème paramètre, s’il est à « true » va activer la cascade, c’est-à-dire que toutes les données imbriquées vont être également supprimées, cela évite d’avoir des fantômes en base de données. • Une méthode « deleteAll() » existe aussi, au lieu de prendre l’id en paramètre elle prend un condition.

  38. Objets, Collections et Evénements • Cette partie va aborder l’architecture interne de CakePHP afin de comprendre ses principaux mécanismes et voir comment en utiliser certains dans nos applications. • L’Object est un élément de base CakePHP dont beaucoup de composants héritent comme la classe Controler, Model ou View. • Ces trois classes MVC sont des Singletons, elles ne sont donc instanciées qu’une seule fois lors de l’exécution d’une requête serveur.

  39. Objets, Collections et Evénements • D’autres composants CakePHP comme le Behavior ou le Component peuvent avoir plusieurs instances, leurs Factories sont les Collections ou plutôt même des « ObjectCollection ». C’est-à-dire que ce sont ces classes de Collection qui s’occupent d’y accéder. • Toute Collection peut être chargée avec « load() » ou déchargée avec « unload() ». • On peut également déclencher manuellement tous les callbacks sur une collection grâce à « trigger() ». • Les callbacks d’un élément d’une Collection peuvent être désactivés avec « disable() » et réactivée avec « enable() ».

  40. Objets, Collections et Evénements Représentation en digramme de classe des Collections CakePHP

  41. Objets, Collections et Evénements • Cela leur permet d’avoir tous un système de callbacks (vu précédemment) et accessoirement de pouvoir déclencher ou « trigguer » un certain nombre d’événements. • Le déclenchement et la création d’événements permet notamment de garder un minimum de couplage entre les classes de CakePHP qui interagissent.

  42. Objets, Collections et Evénements • La plupart des composants visibles, que ce soit des Singletons ou des Collections implémentent une Interface d’écouteur d’événements (Observer), « CakeEventListener ». Le rôle d’un écouteur est d’implémenter la méthode « implemetedEvents » qui est rien que la liste des événements écoutés avec leurs Callbacks. • Il est tout a fait possible d’utiliser ce mécanisme dans nos propres classes, notamment dans les Plugins qui nécessitent une vraie indépendance.

  43. Objets, Collections et Evénements • On pourra propager n’importe où dans le code un événement grâce au gestionnaire d’événements « CakeEventManager ». A noter qu’on peut également attacher un Callback particulier lors du déclenchement. • On pourra attacher un écouteur d’événement (action de Dispatch) à un autre endroit du code, on créera ainsi un Hook. • Comme n’importe quels Hooks il est également possible de définir leur priorité dans CakePHP.

  44. Les exceptions • CakePHP possède une liste de classes d’Exceptions issues de CakeException. • Il est possible de créer ses propre classes d’Exception en les faisant hériter de CakeException. • CakePHPTry l’ensemble du code et a son propre Handler pour gérer les exceptions. • Pour rester dans cette logique et si on désire faire un traitement particulier des exceptions il est possible de faire son propre Handler: « Configure::write('Exception.handler', 'AppExceptionHandler::handle');» • De la même façon on peut uniquement personnaliser le Renderer, c’est-à-dire les messages affichés: « Configure::write('Exception.renderer', 'AppExceptionHandler::handle');»

  45. Les librairies intégrées • Nous n’allons pas énumérer toutes les libraires mais uniquement celles qui vous permettrons d’architecturer votre code et celles incontournables en terme de fonctionnalités. • Les Paradigmes d’architectures: Component, Element, Helper, Behavior, Plugin. Il est également possible d’avoir des librairies de code sans architecture particulière, elle s’ajouteront dans le dossier « Lib ». • Les librairies utiles: Authentification, ACL, Translate, Security, Email, Cache, Form, Paginator et Containable.

  46. Les librairies intégrées – Component (composant): • Son but est de factoriser du code entre plusieurs Contrôleurs, on peut le voir comme une librairie de traitement qui leur est destinée. • Un Component se charge grâce à l’attribut « components » ajouté dans le contrôleur. • Il existe des Components intégrés mais il est tout à fait possible d’en créer des nouveaux. • Un Component implémente l’écouteur d’événements, il est donc pourvu de callbacks comme le contrôleur. • Au lieu d’avoir un callback « beforeFilter() » il a « startup() » qui est appelé entre le « beforeFilter() » du contrôleur et l’exécution de l’action.

  47. Les librairies intégrées – Element (élément) • Un Element permet de factoriser du code de vue très simplement. • Il s’agit d’une mini-vue auquel on va transmettre des variables. • On utilise les Elements en lieu et place des blocs pour principalement 2 raisons: • lorsqu’il s’agit de quelque chose de très récurent et de plutôt général, qu’on pourrait réutiliser dans un autre projet, • lorsqu’on veut un bloc « cachable », un Element peut effectivement prendre en compte des options de caching.

  48. Les librairies intégrées – Helper (assistant) • Le Helper est à la vue ce qu’est le Conponent au contrôleur. • Il permet de factoriser du code de vue mais est généralement destiné aux opérations plus complexes et se structure en module. Il s’agit généralement d’une boite à outil proposant un panel d’assistants sur un objet particulier. On va par exemple avoir un Helper de formulaires qui va nous offrir toutes les méthodes pour construire un form HTML. • Le Helper dispose de callbacks particuliers ciblés sur le rendering. • L’utilisation d’un Helper se déclare dans le contrôleur grâce à l’attribut « helpers ».

  49. Les librairies intégrées – Behavior (comportement) • Le Behavior est au modèle ce qu’est le Conponent au contrôleur. • Un Behavior implémente l’écouteur d’événements, il est donc pourvu de callbacks comme le Component. • Les callbacks sont liées aux actions sur les données: • « beforeValidate() » • « beforeFind() » / « afterFind() » • « beforeSave() » / « afterSave() » • « beforeDelete() » / « afterDelete() » • « setup() » / « cleanup() »: ces hooks sont déclenchés lors de l’attachement / détachement au modèle. • Les behaviors s’attachent au modèle grâce à l’attribut « actsAs ».

  50. Les librairies intégrées – Plugin (greffon) • Un Plugin est un module complet indépendant, reprenant l’architecture d’une application et utilisant les mêmes Paradigmes que cette dernière. • Un Plugin est comparable à un module dans Zend. • Un Plugin se charge dans le bootstrap (dans « Config ») grâce à « CakePlugin::load() » • Un Plugin peut également avoir ses propres routes dans son dossier « Config ». • Il peut également avoir son propre bootstrap pour initialiser les composants dont il a besoin. • Pour charger les routes et le bootstrap du plugin dans l’application:CakePlugin::load(myPlugin', array('bootstrap' => true, 'routes' => true));-> A noter qu’un tableau de nom de fichiers peut être passés à la place du booléen.

More Related