Bibliothèques pour plugins WordPress, partie 1
Plus vous travaillez avec WordPress, en particulier si vous utilisez des outils comme Composer et autres, plus vous trouverez probablement certaines bibliothèques, outils et éléments similaires qui constituent la base des projets sur lesquels vous travaillez.
Parfois, vous pouvez les trouver en parcourant le code d’autres personnes, peut-être que vous les trouverez en parcourant GitHub, ou peut-être que quelqu’un avec qui vous travaillez suggérera une bibliothèque (ou quelques-unes) en fonction d’un projet.
Personnellement, j’ai eu l’expérience de tout ce qui précède, et plus je travaille sur la création de solutions pour moi-même ou pour les autres, plus je me retrouve à mettre en place la même fondation pour chaque projet (qui est généralement un plugin quelconque) .
Bibliothèques pour plugins WordPress
À cette fin, j’ai pensé qu’il pourrait être utile de partager les bibliothèques que j’utilise lors de la création de plugins WordPress. Le contenu sera réparti sur quelques messages pour que chacun soit court et ciblé, mais vous trouverez peut-être quelque chose que vous n’avez pas utilisé auparavant (ou qui améliorera votre utilisation actuelle).
PHPUnit
Quiconque a écrit du code dans n’importe quel langage de programmation connaît probablement n’importe quel type de bibliothèque *Unit. En bref, c’est un moyen d’écrire facilement des tests unitaires.
Depuis la page d’accueil du projet :
PHPUnit est un framework de test orienté programmeur pour PHP. Il s’agit d’une instance de l’architecture xUnit pour les frameworks de tests unitaires.
Je ne suis pas quelqu’un qui souscrit nécessairement à une couverture de code à 100% (et c’est un sujet pour un autre article), mais si vous allez écrire des tests unitaires, alors c’est la bibliothèque de facto pour les tests unitaires de votre code.
GrumPHP
Tout au long de cette année, GrumPHP est sans doute devenu ma bibliothèque préférée (bien qu’elle soit améliorée par des bibliothèques supplémentaires que je couvrirai tout au long de cette série d’articles).
J’en ai parlé dans d’autres posts. Bien qu’il se décrive comme un «outil de qualité de code», vous ne pouvez vraiment pas vous empêcher de voir les avantages jusqu’à ce que vous le connectiez pour surveiller votre code avant d’essayer de le valider dans un référentiel.
La description plus longue est :
Si les tests échouent, vous ne pourrez pas valider vos modifications. Cet outil pratique améliorera non seulement votre base de code, mais il apprendra également à vos collègues à écrire un meilleur code en suivant les meilleures pratiques que vous avez déterminées en équipe.
Et, tout comme si vous aviez utilisé n’importe quel moniteur de normes de codage dans votre IDE, c’est l’une de ces choses qui peuvent être frustrantes à utiliser au début.
Mais au fur et à mesure que vous l’apprenez, il devient plus facile de savoir ce qu’il va signaler, vous commencez donc automatiquement à écrire du code qui a un niveau de qualité supérieur.
PHPMD
PHPMD (abréviation de PHP Mess Detector) fonctionne bien en conjonction avec GrumPHP dans la mesure où il peut traiter votre code avant de le valider dans un référentiel.
Le projet se décrit comme :
Il prend une base de code source PHP donnée et recherche plusieurs problèmes potentiels dans cette source.
Comme avec de nombreuses bibliothèques similaires, celle-ci peut configurer un ensemble de règles afin que vous puissiez facilement activer et désactiver les choses en fonction de ce que vous ou votre équipe préférez.
Analyseur PHP
L’idée d’avoir une configuration de bibliothèque d’analyseur PHP pour analyser votre code semble un peu méta, non ? Je veux dire, vous avez le runtime PHP qui le fait, et de nombreux IDE le font également, mais cela fonctionne d’une manière légèrement différente.
Depuis le référentiel :
Il s’agit d’un analyseur PHP 5.2 à PHP 7.1 écrit en PHP. Son but est de simplifier l’analyse et la manipulation de code statique.
Pour ceux qui connaissent le fonctionnement des langages de programmation (et donc des grammaires), l’idée de faire une analyse statique du code aura du sens.
Quoi qu’il en soit, il s’agit d’une autre bibliothèque qui permet d’améliorer la qualité du code en réduisant la complexité du code.
Plus à venir
À la fin de la série, je vous expliquerai comment incorporer tout cela dans un composer.jsonfichier que vous pourrez utiliser dans votre projet.
Lorsque vous travaillez sur une solution pour un client, vous devrez peut-être modifier les versions de chacun de ces outils, mais vous constaterez que la plupart d’entre eux offrent un support remontant à PHP5.6 et jusqu’à PHP7.1.