Et tout au long de la s\u00e9rie, je vais couvrir tout ce qui est indiqu\u00e9 ci-dessus. Mais pour ce faire, je vais couvrir chaque composant un par un.<\/p>\n
L’article d’aujourd’hui se concentrera sur les normes de codage PHP. J’ai \u00e9crit beaucoup de mat\u00e9riel concernant les normes de codage WordPress, mais au cours de la derni\u00e8re ann\u00e9e ou plus, j’ai commenc\u00e9 \u00e0 travailler davantage avec PSR, et c’est donc ce qui sera couvert dans cet article.<\/p>\n
En remarque, sachez qu’une grande partie de ce qui est couvert peut \u00eatre traduite dans les normes de codage WordPress si vous le souhaitez, et il sera clair o\u00f9 vous apporterez les modifications.<\/p>\n
Cela dit, commen\u00e7ons.<\/p>\n
Norme de codage PHP dans Visual Studio Code<\/h2>\n
Tout d’abord, assurez-vous d’avoir les pr\u00e9requis qui sont tous couverts dans les articles pr\u00e9c\u00e9dents de cette s\u00e9rie. \u00c0 savoir:<\/p>\n
- \n
- Un IDE pour le d\u00e9veloppement WordPress<\/a><\/li>\n
- Utilisation des param\u00e8tres utilisateur dans Visual Studio Code<\/a><\/strong><\/li>\n<\/ol>\n
Chacun des \u00e9l\u00e9ments ci-dessus explique comment installer, configurer et g\u00e9rer Visual Studio Code et les bases de la compr\u00e9hension des param\u00e8tres utilisateur (ainsi que les polices pr\u00e9f\u00e9r\u00e9es, etc.).<\/p>\n
Et avec cela, il est temps d’installer la prise en charge du reniflage de code et des r\u00e8gles pour les styles de codage PHP bas\u00e9s sur PSR-2<\/a><\/strong>.<\/p>\n
[restrict pay\u00e9="true\u00a0\u00bb]<\/p>\n
Avant de dire \u00e0 Code que vous souhaitez utiliser cet ensemble particulier de r\u00e8gles, vous pouvez ajouter quelques \u00e9l\u00e9ments \u00e0 votre fichier de param\u00e8tres.<\/p>\n
1 Une mise \u00e0 jour de vos param\u00e8tres utilisateur<\/h3>\n
N’oubliez pas que pour mettre \u00e0 jour vos param\u00e8tres utilisateur, il vous suffit de cliquer sur Code<\/strong> puis d’acc\u00e9der \u00e0 Param\u00e8tres<\/strong>, ou vous pouvez utiliser le raccourci Cmd+,<\/strong> (ou l’\u00e9quivalent sur votre syst\u00e8me d’exploitation).<\/p>\n
Cela fera appara\u00eetre une fen\u00eatre famili\u00e8re\u00a0:<\/p>\n
![\"Utilisation](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-164430-61e7651f87631.png\")
<\/a><\/p>\nEnsuite, lancez la commande suivante dans votre terminal\u00a0:<\/p>\n
$ brew install php-code-sniffer<\/code><\/pre>\nNotez que lorsque je fais cela, je l’ai d\u00e9j\u00e0 install\u00e9, mais je suis invit\u00e9 \u00e0 mettre \u00e0 niveau (donc je l’ai fait).<\/p>\n
![\"Utilisation](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-164430-61e76523859b2.png\")
<\/a><\/p>\nEt puis \u00e0 l’int\u00e9rieur, vous pouvez ajouter les lignes suivantes<\/a><\/strong> \u00e0 votre fichier de param\u00e8tres utilisateur\u00a0:<\/p>\n
{\n \/\/ ...\n\n \/\/ PHP Settings.\n \"php.suggest.basic\": true,\n \"php.validate.executablePath\": \"\/usr\/local\/bin\/php\",\n \"php.validate.run\": \"onSave\",\n\n \/\/ ...\n}<\/code><\/pre>\nSi vous n’\u00eates pas s\u00fbr du chemin d’acc\u00e8s \u00e0 votre installation locale de PHP, vous pouvez ex\u00e9cuter la commande suivante dans votre terminal\u00a0:<\/p>\n
$ which php<\/code><\/pre>\nVoici ce que chaque ligne d\u00e9crit\u00a0:<\/p>\n
- \n
- php.suggest.basic.<\/strong> Cela contr\u00f4le si oui ou non l’EDI fera des suggestions pour le code bas\u00e9 sur PHP (ce qui est utile lors de l’\u00e9criture de code). Consid\u00e9rez cela comme une saisie semi-automatique, un aper\u00e7u de l’API ou tout ce que vos IDE actuels ou pr\u00e9c\u00e9dents peuvent appeler.<\/li>\n
- php.validate.executablePath.<\/strong> Cela r\u00e9f\u00e9rence simplement le binaire PHP sur le disque. Ceci est utile pour qu’il ex\u00e9cute la version de PHP sur laquelle vos projets sont ex\u00e9cut\u00e9s.<\/li>\n
- php.validate.run.<\/strong> Comme vous vous en doutez, cela validera votre code lorsque vous enregistrerez votre fichier. Vous pouvez le faire au fur et \u00e0 mesure que vous tapez, mais en fonction de la quantit\u00e9 de frappe, de la vitesse \u00e0 laquelle vous tapez ou simplement de la nature de vos habitudes, il peut \u00eatre plus facile de le faire sur Enregistrer<\/strong> (d’o\u00f9 la raison pour laquelle je l’utilise plut\u00f4t que l’alternative qui est onType<\/strong> ).<\/li>\n<\/ol>\n
Tout cela est agr\u00e9able et n\u00e9cessaire, \u00e0 mon avis, mais cela ne nous permet pas de renifler du code. Portons donc notre attention sur cela maintenant.<\/p>\n
2 Ajout du reniflage de code<\/h3>\n
Rappel de la section pr\u00e9c\u00e9dente, je suis all\u00e9 de l’avant et j’ai install\u00e9 PHP Code Sniffer via Homebrew mais comment pouvons-nous ajouter le support via Visual Studio Code ?<\/p>\n
Je veux dire, il a son propre march\u00e9 o\u00f9 nous pouvons l’ajouter, mais y a-t-il d’autres choses que nous pouvons faire\u00a0? Depuis que nous l’avons install\u00e9 via Homebrew, c’est fait.<\/p>\n
Il s’agit maintenant de le lier \u00e0 Code. Il s’agit de faire deux choses :<\/p>\n
- \n
- Installation d’un plugin dans Code,<\/li>\n
- Mise \u00e0 jour de vos param\u00e8tres d’utilisateur (une fois de plus).<\/li>\n<\/ol>\n
Tout d’abord, acc\u00e9dez \u00e0 l’\u00e9cran des plugins dans Code, puis recherchez phpcs<\/strong>. Vous devriez voir quelque chose comme ce qui suit\u00a0:<\/p>\n
![\"Utilisation](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-164430-61e7652770779.png\")
<\/a><\/p>\nCliquez sur Installer<\/strong> puis sur Recharger<\/strong> si vous y \u00eates invit\u00e9.<\/p>\n
- php.validate.executablePath.<\/strong> Cela r\u00e9f\u00e9rence simplement le binaire PHP sur le disque. Ceci est utile pour qu’il ex\u00e9cute la version de PHP sur laquelle vos projets sont ex\u00e9cut\u00e9s.<\/li>\n
- Utilisation des param\u00e8tres utilisateur dans Visual Studio Code<\/a><\/strong><\/li>\n<\/ol>\n
![\"Utilisation](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-164430-61e7652c067ab.png\")
<\/a><\/p>\n