LABINVENT (InventIrap)

h1. CakePhp

{{>toc}}

h2. Liens

* ROADMAP: https://github.com/cakephp/cakephp/wiki

* *Migrations* plugin: http://book.cakephp.org/3.0/fr/migrations.html

* *CONVENTIONS*: https://book.cakephp.org/3.0/fr/intro/conventions.html

* Déploiement : https://book.cakephp.org/3.0/fr/deployment.html

* Forum cakephp: http://discourse.cakephp.org

* Debug Kit : https://book.cakephp.org/3.0/fr/debug-kit.html

* Quickstart tutorial: http://book.cakephp.org/3.0/en/quickstart.html

* Bookmarker tutorial: https://github.com/cakephp/bookmarker-tutorial

* Cakephp CRUD: https://github.com/FriendsOfCake/crud

* Plugin Chronos pour gérer les dates plus facilement : https://book.cakephp.org/3.0/fr/chronos.html

h2. CONVENTIONS CAKEPHP

https://book.cakephp.org/3.0/fr/intro/conventions.html

h3. SYNTHÈSE GÉNÉRALE

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

<pre>

    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

</pre>

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.

h3. Controleurs

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. Les méthodes privées ou protégées ne sont pas accessibles avec le routing

UsersController (qui serait défini dans le nom de fichier UsersController.php) est accessible à l’adresse http://exemple.com/users.

/article-categories/view-all est la bonne forme pour accéder à l’action ArticleCategoriesController::viewAll()

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

<pre>

$this->Html->link('link-title', [

    'prefix' => 'MyPrefix' // CamelCased

    'plugin' => 'MyPlugin', // CamelCased

    'controller' => 'ControllerName', // CamelCased

    'action' => 'actionName' // camelBacked

]

</pre>

h3. Fichiers et 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 pour l’autoloading (chargement automatique). 

Voici quelques exemples de noms de classes et de fichiers:

<pre>

    La classe controller LatestArticlesController devra se trouver dans un fichier nommé LatestArticlesController.php.

    La classe Component (Composant) MyHandyComponent devra se trouver dans un fichier nommé MyHandyComponent.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é BestEverHelper.php.

</pre>

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

h3. Modèles et 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é* (underscore). 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 une autre langue, CakePHP ne va pas pouvoir convertir correctement les bonnes inflections (du singulier vers le pluriel et 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*.

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 users via une clé étrangère user_id*. Pour une table avec un nom de plusieurs mots comme *article_categories, la clé é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 nom des tables qu’elles unissent, dans l’ordre alphabétique (articles_tags plutôt que tags_articles)*.

h3. Vues

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

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

h2. Utilisation du serveur web de dev de CakePHP

 (à la place de apache)

/!\ Votre serveur MySQL doit être lancé !!!

* Se placer à la racine du projet.

* Lancer la commande suivante :

 <pre> bin/cake server </pre>

* Rendez-vous sur http://localhost:8765/

h2. Pour mettre à jour CakePHP

* Utiliser le composer : "php composer.phar update" à la racine de l'application

> Voir : http://book.cakephp.org/3.0/fr/installation.html#rester-a-jour-avec-les-derniers-changements-de-cakephp

* Puis il faut modifier le fichier : ./vendor/cakephp/cakephp/src/View/Helper/PaginatorHelper.php

  Ce fichier contient le template de l'helper "paginator" et il faut modifier le tableau "$_defaultConfig" et remplacer les balise "li" par des balises "span".

  Enfin dans le même tableau, il faut remplacer la ligne suivante : 

> 'current' => '<span class="active"><a href="">{{text}}</a></span>',

           Par : 

> 'current' => '<span class="current">{{text}}</span>',

* Puis il faut vider le cache de l'application (et du navigateur) pour que debug_kit fonctionne.