L'essentiel de CakePHP

Aborder les normes de développement

TESTEZ LINKEDIN LEARNING GRATUITEMENT ET SANS ENGAGEMENT

Tester maintenant Afficher tous les abonnements
Les frameworks PHP utilisent, pour la plupart, la norme PSR. Vous allez voir comment respecter cette norme.
08:38

Transcription

Nous allons voir maintenant les normes de développement. Là je vous présente le site qui s'appelle PHP-FIG. C'est un site qui regroupe un ensemble de projets php. Ce groupe permet de parler de points communs entre les projets, et de trouver comment ils peuvent travailler ensemble pour pouvoir normer chacun de ces projets. Vous verrez que dans Member, ici vous avez des membres comme CakePHP, Composer, Drupal, et aussi Joomla, phpBB, TYPO3, Symfony. Donc vous avez vraiment beaucoup d'acteurs du framework php qui sont là. Les normes PSR, ce sont des propositions de changement ou de normes qui sont votées afin d'être acceptées par les membres. Un changement est radical alors qu'une critique aura des impacts mineurs. CakePHP, Symfony, utilisent du coup ces règles-là. Je ne vais pas vous expliquer l'ensemble des règles, elles sont assez claires et concises sur ce site, mais je vais vous donner quelques exemples. Donc par exemple si vous allez ici dans les recommandations, vous pouvez voir différents numéros de normes, et la PSR 1, donc c'est sur les basic coding standards, ça montre quelques tags qui doivent être utilisés dans votre code, ou encore, quel encoding par défaut, vous devez utiliser. Donc par exemples, l'UTF-8, doit être utilisé par défaut. Vous devez utiliser certains tags pour définir vos fichiers PHP. Ou encore que les méthodes doivent être écrites en camelCase. camelCase, ça signifie du coup, sans underscore, et c'est juste avec des majuscules à chaque mot. Ensuite vous avez le PSR-2. Donc celui-là, il parle du coup de l'indentation de vos conditions, par exemple. Ensuite vous avez la PSR-5 qui est utile pour les PHPDoc, qui vous permet de faire une API de votre Doc par exemple. Je vous laisse du coup regarder ce site, où il y a la plupart des règles qu'il faut suivre pour le PHP. Nous allons voir maintenant les normes spécifiques à CakePHP, donc par exemple, il est déconseillé d'écrire des lignes de plus de cent caractères. Cent-un, c'est vraiment la limite maximum. Il faut vraiment que votre code soit-- qu'un ligne soit au maximum de cent caractères. Ensuite, concernant les conditions, il faut vraiment qu'il y ait toujours un espace après le if, un espace avant l'accolade. Et ceci même pour les elseif et les else. Il faut aussi qu'il y ait, du coup, un espace entre vos conditions ici. Et toujours un retour-chariot. Donc ici vous avez le if, le elseif, et le else qui sera la valeur par défaut. Ensuite, lorsque vous faites une condition, il faut impérativement éviter ce genre de phrases. Il ne faut pas du code inline comme ça. Ça, ça va être difficilement compréhensible par quelqu'un qui va relire votre code. Ce genre de condition-là non plus. Ici vous n'avez pas d'accolade, du coup la bonne condition, c'est celle-ci. Vous avez bien les accolades, et votre code entre accolades. De temps en temps, vous avez besoin de récupérer une valeur d'une classe, d'une fonction, qui se trouve dans une classe, et de tester sa valeur. Ici par exemle, ça c'est pas bon, puisque ici vous allez prendre la valeur, le retour de ma fonction, et vous allez le mettre dans ma variable. Et ça vous allez le mettre dans une condition. Ce n'est pas bon, parce que ici, ça sera toujours valable à vrai, puisque vous assignez simplement une valeur. Vous ne faites pas une condition ici. Donc la bonne syntaxe, c'est celle-ci. Vous affectez déjà la variable, et ensuite vous testez si elle est bonne ou non. Si elle est existante. Ensuite il n'est pas rare de voir des conditions ternaires, donc c'est celle-ci. Conditions ternaires, donc ici, on teste l'existence de option variable, et si c'est le cas, dans variable on met $options ['variable']. Et dans le cas contraire, nous mettons true. Ensuite, ici donc j'étais dans un fichier Index.php. Je vais aller dans un Index.ctp, Donc pour KegPHP template. Je vais dans le Index.ctp qui correspond à KegPHP template. Donc ici nous allons voir les conditions dans ce template. J'ai ouvert une balisePHP, je l'ai fermée ici à la ligne 5. Je teste, savoir si la variable IsAdmin est bien dans le scope, dans la portée de mon fichier Index.ctp. Donc si c'est le cas, je fais un écho de vous êtes administrateur. Donc ça c'est une première façon de faire une condition dans un template CakePHP. Vous avez aussi cette deuxième façon, qui est d'ouvrir une balise PHP, de faire le test, de mettre 2 points pour qu'il y ait l'équivalent de l'accolade, on va dire de faire l'action que vous voulez, et ensuite de faire un endif pour dire : je veux que ma condition s'arrête ici. Ensuite pour tester si une variable est nulle, il est recommandé d'utiliser une version stricte. Qu'est-ce que j'entends par version stricte ? C'est celle-ci : c'est le triple égal. En fait avec le triple égal, vous allez comparer la valeur et le type. Ici je viens de coller quelque chose qui est non recommandé, pourquoi ? Puisque, la variable testée, c'est celle-ci, et la valeur est ici. Généralement, on fait toujours l'inverse. On met toujours, pour des raisons de clarté, on met toujours la variable en premier, et en second, la valeur que l'on souhaite tester. Comme ceci. Ensuite, il n'est pas rare d'avoir, dans CakePHP, des fonctions ce de type-là. Donc ici, vous appelez une fonction from, et ensuite vous en avez tout un tas d'autres que vous devez appeler aussi en fait. Vous devez assigner plein de variables. Il faut bien en fait, que toutes les affectations soient au même niveau. Donc ça c'est pour les méthodes en fait, et les chaînes. Ensuite pour commenter le code, vous avez des choses assez strictes, dans CakePHP, et tout cela c'est toujours pour les mêmes raisons, pour une raison de clarté. Donc ici vous avez votre fonction qui s'appelle ma fonction, et elle ne retourne rien. Du coup il faut bien préciser avec @return void, comme quoi elle ne retourne rien. Et ici il faut expliquer brièvement ce que votre fonction fait. Donc là, c'est comme ça que l'on fait, pour commenter, fidèlement et correctement un code. Ensuite concertant le nommage des fonctions et des classes, il faut faire comme ceci. Les fonctions doivent être en camelback, c'est-à-dire, que chaque première lettre du mot doit être en majuscule. Sauf le premier mot. Concernant les classes, c'est comme le camelback, sauf que le premier mot doit aussi avoir une majuscule. Concernant les propriétés privées et protected, dans CakePHP, il y a certaines spécificités. Donc comme par exemple, pour cette classe exemple, vous avez ici une variable qui est protected, ici une variable qui est en private. Et ces variables-là doivent obligatoirement avoir un underscore au début du nom. Donc cela, c'est juste pour pouvoir bien les différencier, donc bien pouvoir différencier des variables protected et private, des variables publiques. Ensuite pour tester si une variable est empty ou non, donc si elle est vide, ou non, dans CakePHP, vous pouvez faire comme ceci. Ici j'ai une fonction-test, donc avec un paramètre, qui est maVar. Par exemple le premier ici n'est pas recommandé. Pourquoi ? Puisque vous faites appel à une fonction empty. Sauf qu'elle est déjà dans le scope, en fait. La variable maVar. Du coup, elle est déjà définie puisque vous l'avez faite passer obligatoirement dans $maVar. Donc elle est déjà dans le scope, elle est déjà dans l'éxecution du code. Du coup il est recommandé en fait, si vous voulez tester la non-existence de la variable maVar, c'est de faire comme ceci, de ne pas mettre empty devant. Et pour tester l'existence, il suffit juste de ne pas mettre le point d'exclamation qui signifie le non.

L'essentiel de CakePHP

Développez des applications web évolutives avec CakePHP, du simple blog au site e-commerce à fort trafic. Installez et configurez le framework, maîtrisez le routing, etc.

3h39 (45 vidéos)
Aucun commentaire n´est disponible actuellement
 
Logiciel :
CakePHP CakePHP 3
Spécial abonnés
Date de parution :22 nov. 2016

Votre formation est disponible en ligne avec option de téléchargement. Bonne nouvelle : vous ne devez pas choisir entre les deux. Dès que vous achetez une formation, vous disposez des deux options de consultation !

Le téléchargement vous permet de consulter la formation hors ligne et offre une interface plus conviviale. Si vous travaillez sur différents ordinateurs ou que vous ne voulez pas regarder la formation en une seule fois, connectez-vous sur cette page pour consulter en ligne les vidéos de la formation. Nous vous souhaitons un excellent apprentissage avec cette formation vidéo.

N'hésitez pas à nous contacter si vous avez des questions !