Bibliothèques pour plugins WordPress, partie 2
Hier, j’ai commencé une courte série d’articles sur les outils qui, à mon avis, permettent d’écrire du code de haute qualité dans un projet WordPress (en particulier ceux qui sont des plugins construits à l’aide d’une approche orientée objet).
Si vous n’avez pas lu l’article, le premier ensemble d’outils mentionnés est le suivant :
Il y a environ cinq autres outils que j’aime continuer à exécuter sur mes projets. Voici donc les trois suivants avec les deux derniers à venir dans le prochain post.
Bibliothèques pour plugins WordPress, suite
Comme mentionné précédemment, je trouve ces outils utiles chaque fois que je travaille sur des plugins WordPress orientés objet. De plus, ceux-ci sont naturellement répartis sur quelques messages pour que chacun soit court et ciblé.
Renifleur de code PHP
Si vous lisez ce blog depuis un certain temps, vous avez probablement lu un article ou au moins mentionné quelque chose à propos de PHP CodeSniffer. C’est quelque chose que je pense, à tout le moins, que chaque développeur WordPress devrait avoir installé dans son IDE.
Depuis la page de dépôt du projet :
PHP_CodeSniffer tokenise les fichiers PHP, JavaScript et CSS et détecte les violations d’un ensemble défini de normes de codage.
Maintenant, en ce qui concerne les règles, c’est une autre chose. Certaines personnes préfèrent les normes de codage WordPress ; certains préfèrent PSR2, d’autres préfèrent d’autres ensembles de règles. Il ne s’agit pas tant de ce que vous préférez tant que vous ou votre équipe êtes cohérents.
Et c’est ce que cette bibliothèque particulière vous aide à faire. De plus, cela ne fait pas de mal que vous puissiez l’intégrer à votre IDE (en supposant qu’il s’agisse de l’un des éditeurs les plus populaires).
PHPCPD
PHPCPD est une bibliothèque simple qui analyse votre code pour détecter le code en double – qui provient généralement d’un copier-coller ailleurs (même s’il s’agit de votre base de code). L’idée derrière la bibliothèque est de réduire le code en double.
Et ce n’est pas beaucoup plus clair que ça :
phpcpd est un détecteur de copier/coller (CPD) pour le code PHP.
En d’autres termes, c’est une étape pour vous aider à le garder au SEC.
PHPMND
Si l’un des objectifs que nous nous efforçons d’atteindre dans notre code est de le rendre aussi lisible que possible par d’autres qui peuvent récupérer la base de code, la bifurquer ou y contribuer (en particulier en open source), alors nous devons nous assurer que tous de nos valeurs ont des valeurs significatives.
Utiliser des nombres significatifs pour nous mais qui ne décrivent pas ce que fait le code est important, mais ce n’est pas quelque chose que nous faisons, n’est-ce pas ? Ou peut-être que c’est juste moi.
Mais c’est là que PHPMND entre en jeu.
phpmnd est un outil qui vous aide à détecter les nombres magiques dans le code PHP. Par défaut, 0 et 1 ne sont pas considérés comme des nombres magiques.
C’est une bibliothèque simple mais utilisée conjointement avec les bibliothèques de cet article, et l’article précédent peut aider à améliorer continuellement la qualité du code que vous contribuez à vos référentiels.
Un ensemble d’outils de plus
Comme mentionné dans le post précédent, l’objectif sur lequel je travaille est de savoir comment incorporer tout cela dans un composer.jsonfichier que vous pouvez utiliser dans votre projet.
N’oubliez pas non plus que, selon le projet, vous devrez peut-être sélectionner une version de la bibliothèque en fonction de la version de PHP que vous utilisez.