En ce qui concerne la base de code, nous sommes actuellement bien plac\u00e9s. Nous avons commenc\u00e9 \u00e0 refactoriser une grande partie du code en classes plus petites et plus cibl\u00e9es. Et nous venons de mettre en place un registre afin que nous puissions commencer \u00e0 travailler avec des instances d’objets tout au long du plugin sans avoir besoin de trop de couplage.<\/p>\n
Mais il y a toujours un probl\u00e8me auquel nous sommes confront\u00e9s et qui concerne les espaces de noms et le chargement automatique. J’en ai un peu parl\u00e9 il y a quelques ann\u00e9es,<\/a> mais pas en ce qui concerne Composer.<\/p>\n Et c’est ce que nous allons voir dans cet article.<\/p>\n Dans le deuxi\u00e8me article de cette s\u00e9rie<\/a>, nous avons commenc\u00e9 \u00e0 parler de Composer. Si vous demandez \u00e0 la plupart des d\u00e9veloppeurs PHP (y compris ceux qui travaillent sur WordPress), vous entendrez probablement que Composer est un gestionnaire de packages ou un gestionnaire de d\u00e9pendances.<\/p>\n En bref, c’est un moyen pour nous d’int\u00e9grer des biblioth\u00e8ques tierces dans notre projet, puis d’utiliser leurs fonctionnalit\u00e9s (nous n’avons donc pas \u00e0 \u00e9crire notre propre code pour le faire).<\/p>\n Mais il existe une autre fonctionnalit\u00e9 offerte par Composer qui est d’une immense utilit\u00e9, en particulier lorsque vous utilisez de nombreuses classes et que vous ne<\/strong> souhaitez pas utiliser d’instructions require_once dans votre base de code.<\/p>\n Et c’est le chargeur automatique.<\/p>\n Directement du manuel:<\/a><\/p>\n Pour les biblioth\u00e8ques qui sp\u00e9cifient des informations de chargement automatique, Composer g\u00e9n\u00e8re un Si vous avez suivi le code jusqu’\u00e0 pr\u00e9sent, vous verrez que nous utilisons d\u00e9j\u00e0 le chargeur automatique g\u00e9n\u00e9r\u00e9 par Composer.<\/p>\n Dans un premier temps, nous avons d\u00e9fini la configuration n\u00e9cessaire<\/a> :<\/p>\n Ensuite, nous avons commenc\u00e9 \u00e0 l’inclure dans le bootstrap du plugin<\/a> (que nous finaliserons aujourd’hui) :<\/p>\n Mais il y a un probl\u00e8me ici: comment charger uniquement les classes dont nous avons besoin pour la distribution ?<\/p>\n En d’autres termes\u00a0: il existe de nombreuses biblioth\u00e8ques que nous utilisons dans le d\u00e9veloppement pour nous assurer que nous \u00e9crivons du code de haute qualit\u00e9 et conforme aux normes. Mais nous ne voulons pas distribuer 10 Mo de donn\u00e9es \u00e0 ceux qui utilisent notre projet.<\/p>\n Au lieu de cela, nous devons inclure uniquement les fichiers requis, n’est-ce pas\u00a0? Et pour ce faire, nous devons nous assurer que nous g\u00e9n\u00e9rons un chargeur automatique que nous pouvons inclure et qui fait exactement cela.<\/p>\n Tout d’abord, je vais vous montrer la commande<\/a>, puis vous expliquer ce qu’elle fait\u00a0:<\/p>\n Cela g\u00e9n\u00e9rera exactement ce dont nous avons besoin pour que notre projet fonctionne dans un environnement de production. Voici ce que fait chaque drapeau\u00a0:<\/p>\n Si vous \u00eates vraiment curieux d’optimiser le chargeur automatique pour des projets en dehors de ce post, je vous recommande de lire cette page<\/a> dans la documentation de Composer. Cela sort du cadre de ce que nous faisons ici, mais cela peut \u00eatre utile avec d’autres travaux que vous avez actuellement ou que vous ferez \u00e0 l’avenir.<\/p>\n Si vous travaillez sur le Boilerplate sur votre ordinateur local, vous pouvez voir quelque chose comme ceci\u00a0:<\/p>\n Mais si vous ex\u00e9cutez la commande incluse ci-dessus, vous verrez alors quelque chose comme ceci\u00a0:<\/p>\n C’est une grande diff\u00e9rence et c’est un petit projet. Imaginez faire quelque chose de beaucoup plus grand qui va fonctionner en production.<\/p>\n Par exp\u00e9rience, je peux vous dire que les projets peuvent rapidement atteindre 20 Mo ou plus de d\u00e9pendances si vous utilisez une vari\u00e9t\u00e9 de biblioth\u00e8ques tierces pour des choses telles que la journalisation, les requ\u00eates HTTP et les outils de qualit\u00e9 du code.<\/p>\n Les gens diront souvent que vous ne devriez pas inclure le r\u00e9pertoire du fournisseur dans le contr\u00f4le de source et pour une bonne raison\u00a0: cela peut \u00eatre \u00e9norme.<\/p>\n M\u00eame la documentation de Composer en parle :<\/a><\/p>\n La meilleure pratique consiste \u00e0 demander \u00e0 tous les d\u00e9veloppeurs d’utiliser Composer pour installer les d\u00e9pendances. De m\u00eame, le serveur de build, CI, les outils de d\u00e9ploiement, etc. doivent \u00eatre adapt\u00e9s pour ex\u00e9cuter Composer dans le cadre de l’amor\u00e7age de leur projet.<\/p>\n<\/blockquote>\n Alors qu’est-ce qu’on est cens\u00e9 faire? Nous avons besoin du chargeur automatique et nous avons besoin de certaines d\u00e9pendances car nos utilisateurs ne sauront pas ex\u00e9cuter (et ne devraient pas non plus ex\u00e9cuter\u00a0!) Composer chaque fois qu’ils t\u00e9l\u00e9chargent notre travail.<\/p>\n En raison de la nature de WordPress et du travail que nous effectuons, nous devrons valider le r\u00e9pertoire des fournisseurs, mais uniquement avec certaines exigences.<\/p>\n Faisons donc chaque \u00e9tape et voyons \u00e0 quoi cela ressemble lorsque nous avons termin\u00e9.<\/p>\n Pour cr\u00e9er une nouvelle branche depuis le terminal, saisissez la commande suivante<\/a>\u00a0:<\/p>\n Cela prendra tout le code sur lequel nous travaillons et cr\u00e9era ensuite une nouvelle branche avec. Puisque ce sera la branche que nous utiliserons pour agir comme ce que nos utilisateurs utiliseront (nous parlerons de master<\/strong> dans un prochain article).<\/p>\n Tout d’abord, examinez votre fichier composer.json et assurez-vous qu’il inclut les \u00e9l\u00e9ments suivants\u00a0:<\/p>\n Nous devons maintenant nous assurer que nous ex\u00e9cutons la commande Composer ci-dessus pour nous assurer que rien d’autre que ce dont nous avons besoin ne se trouve dans le\u00a0 r\u00e9pertoire du fournisseur<\/strong>.<\/p>\n Maintenant, nous devons mettre \u00e0 jour gitignore.<\/p>\n Et si vous avez suivi \u00e0 la fois la s\u00e9rie et le message jusqu’\u00e0 pr\u00e9sent, alors vous savez que cela ressemblera \u00e0 quelque chose comme \u00e7a (cela peut inclure plus ou moins mais devrait inclure au moins cela).<\/p>\n Pour moi, cela ressemble \u00e0 ceci<\/a> :<\/p>\n Selon que vous utilisez un terminal ou un client, vous verrez qu’il y a de nouveaux fichiers \u00e0 valider (\u00e0 partir du r\u00e9pertoire du fournisseur, en particulier). Ajoutez-les donc \u00e0 votre branche.<\/p>\n Validez ensuite vos modifications<\/a>. Vous devrez peut-\u00eatre sp\u00e9cifier les \u00e9l\u00e9ments suivants si vous travaillez dans le terminal\u00a0:<\/p>\n Et avec cela, votre code devrait fonctionner et \u00eatre disponible sur GitHub (ou tout autre service de contr\u00f4le de code source que vous utilisez). Vous pouvez voir ce que j’ai de disponible ici<\/a>.<\/p>\n Maintenant que nous avons toutes les pi\u00e8ces n\u00e9cessaires en place, il est temps de commencer \u00e0 utiliser Composer, le chargeur automatique, nos classes abstraites et notre registre pour commencer \u00e0 ajouter des fonctionnalit\u00e9s de base au WordPress Widget Boilerplate afin que nous ayons quelque chose \u00e0 montrer pour notre travail .<\/p>\n Pour ceux qui sont curieux, je pr\u00e9vois pour le moment de garder les branches organis\u00e9es comme telles :<\/p>\n Pour l’instant, cependant, passez en revue ce qui est couvert dans cet article et nous le reprendrons dans le prochain article.<\/p>\nLe passe-partout du widget WordPress\u00a0: refactorisation, partie 6<\/h2>\n
L’autochargeur d\u00e9fini<\/h3>\n
\n
vendor\/autoload.php<\/code>fichier. Vous pouvez simplement inclure ce fichier et commencer \u00e0 utiliser les classes fournies par ces biblioth\u00e8ques sans aucun travail suppl\u00e9mentaire\u00a0:<\/p>\n<\/blockquote>\n{\n \"name\": \"wordpress-widget-boilerplate\/wordpress-widget-boilerplate\",\n \"description\": \"An organized, maintainable boilerplate for building widgets using WordPress best practices.\",\n \"type\": \"wordpress-plugin\",\n \"license\": \"GPL-3.0-or-later\",\n \"homepage\": \"https:\/\/github.com\/tommcfarlin\/WordPress-Widget-Boilerplate\",\n \"authors\": [\n {\n \"name\": \"Tom McFarlin\",\n \"email\": \"tom@pressware.co\",\n \"homepage\": \"https:\/\/pressware.co\"\n }\n ],\n \"support\": {\n \"issues\": \"https:\/\/github.com\/tommcfarlin\/WordPress-Widget-Boilerplate\/issues\"\n },\n \"config\": {\n \"preferred-install\": \"dist\",\n \"platform\": {\n \"php\": \"7.1\"\n }\n },\n \"repositories\": [\n {\n \"type\": \"composer\",\n \"url\": \"https:\/\/wpackagist.org\"\n }\n ],\n \"require\": {\n \"php\": \"7.1\",\n \"composer\/installers\": \"^1.4\"\n },\n \"require-dev\": {\n \"friendsofphp\/php-cs-fixer\": \"^2.13.1\",\n \"jakub-onderka\/php-parallel-lint\": \"^1.0.0\",\n \"phpmd\/phpmd\": \"^v2.6.0\",\n \"nikic\/php-parser\": \"^4.0\",\n \"ocramius\/proxy-manager\": \"^2.0.0\",\n \"phpro\/grumphp\": \"^0.13.1\"\n },\n \"scripts\": {\n \"test\": [\n \".\/vendor\/bin\/grumphp run\"\n ]\n },\n \"minimum-stability\": \"stable\"\n }<\/code><\/pre>\n<?php\n\n\/\/ Include the autoloader.\n\/\/ TODO: Note this has not yet been defined.\nrequire_once __DIR__. '\/inc\/autoload.php';\n<\/code><\/pre>\n$ composer install --no-dev --no-ansi --no-interaction --optimize-autoloader --no-progress --prefer-dist<\/code><\/pre>\n\n
Toujours int\u00e9ress\u00e9?<\/h4>\n
\u00c0 quoi cela ressemble-t-il dans le Boilerplate\u00a0?<\/h2>\n
![\"Widgets](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-161015-61e719e23bf2d.png\")
<\/a><\/p>\n![\"Widgets](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-161015-61e719e5afd5a.png\")
<\/a><\/p>\nAllons-nous inclure dans notre r\u00e9pertoire de fournisseurs\u00a0?<\/h2>\n
\n
\n
Cr\u00e9ation de la branche de publication<\/h3>\n
$ git checkout -b release<\/code><\/pre>\n\"autoload\": {\n \"psr-4\": {\n \"WordPressWidgetBoilerplate\": \"src\/\",\n \"WordPressWidgetBoilerplateSubscriber\": \"src\/Subscriber\/\",\n \"WordPressWidgetBoilerplateUtilities\": \"src\/Utilities\/\",\n \"WordPressWidgetBoilerplateViews\": \"src\/Views\/\"\n }\n},<\/code><\/pre>\n$ composer install --no-dev --no-ansi --no-interaction --optimize-autoloader --no-progress --prefer-dist<\/code><\/pre>\nMettre \u00e0 jour ce que nous ignorons<\/h3>\n
*.DS_Store\n*.log\nwp-config.php\nwp-content\/advanced-cache.php\nwp-content\/backup-db\/\nwp-content\/backups\/\nwp-content\/blogs.dir\/\nwp-content\/cache\/\nwp-content\/upgrade\/\nwp-content\/uploads\/\nwp-content\/mu-plugins\/\nwp-content\/wp-cache-config.php\nwp-content\/plugins\/hello.php\n\n\/.htaccess\n\/license.txt\n\/readme.html\n\/sitemap.xml\n\/sitemap.xml.gz\n\n\/vendor\/**\/.git\n\/vendor\/bin\ncomposer.lock\n<\/code><\/pre>\n$ git push --set-upstream origin release<\/code><\/pre>\nAjouter des fonctionnalit\u00e9s<\/h2>\n
\n