No que diz respeito \u00e0 base de c\u00f3digo, estamos em um bom lugar agora. Come\u00e7amos a refatorar grande parte do c\u00f3digo em classes menores e mais focadas. E acabamos de configurar um Registro para que possamos come\u00e7ar a trabalhar com inst\u00e2ncias de objetos em todo o plugin sem a necessidade de muito acoplamento.<\/p>\n
Mas ainda h\u00e1 um problema que estamos enfrentando e trata de namespaces e carregamento autom\u00e1tico. Eu falei um pouco sobre isso alguns anos atr\u00e1s,<\/a> mas n\u00e3o no que se refere ao Composer.<\/p>\n E \u00e9 isso que vamos ver neste post.<\/p>\n No segundo post desta s\u00e9rie<\/a>, come\u00e7amos a falar sobre o Composer. Se voc\u00ea perguntar \u00e0 maioria dos desenvolvedores PHP (incluindo aqueles que trabalham no WordPress), provavelmente ouvir\u00e1 que o Composer \u00e9 um gerenciador de pacotes ou um gerenciador de depend\u00eancias.<\/p>\n Resumindo, \u00e9 uma forma de trazermos bibliotecas de terceiros para nosso projeto e ent\u00e3o utilizarmos seus recursos (para que n\u00e3o tenhamos que escrever nosso pr\u00f3prio c\u00f3digo para isso).<\/p>\n Mas h\u00e1 outro recurso que o Composer oferece que \u00e9 de imensa utilidade, especialmente quando voc\u00ea est\u00e1 usando muitas classes e n\u00e3o<\/strong> deseja usar instru\u00e7\u00f5es require_once em toda a sua base de c\u00f3digo.<\/p>\n E esse \u00e9 o carregador autom\u00e1tico.<\/p>\n Direto do manual:<\/a><\/p>\n Para bibliotecas que especificam informa\u00e7\u00f5es de carregamento autom\u00e1tico, o Composer gera um Se voc\u00ea acompanhou o c\u00f3digo at\u00e9 agora, ver\u00e1 que j\u00e1 estamos usando o autoloader gerado pelo Composer.<\/p>\n Primeiro, definimos a configura\u00e7\u00e3o necess\u00e1ria<\/a> :<\/p>\n Ent\u00e3o come\u00e7amos a inclu\u00ed-lo no bootstrap do plugin<\/a> (que finalizaremos hoje):<\/p>\n Mas h\u00e1 um problema aqui: como carregamos apenas as classes que precisamos para distribui\u00e7\u00e3o?<\/p>\n Colocando de outra forma: h\u00e1 muitas bibliotecas que estamos usando no desenvolvimento para garantir que estamos escrevendo c\u00f3digo de alta qualidade e compat\u00edvel com os padr\u00f5es. Mas n\u00e3o queremos distribuir 10 MB de dados para quem usa nosso projeto.<\/p>\n Em vez disso, precisamos incluir apenas os arquivos necess\u00e1rios, certo? E para fazer isso, precisamos ter certeza de que geramos um autoloader que possamos incluir e que fa\u00e7a exatamente isso.<\/p>\n Primeiro, mostrarei o comando<\/a> e explicarei o que ele faz:<\/p>\n Isso gerar\u00e1 exatamente o que precisamos para que nosso projeto funcione em um ambiente de produ\u00e7\u00e3o. Veja o que cada sinalizador faz:<\/p>\n Se voc\u00ea est\u00e1 realmente curioso sobre como otimizar o autoloader para projetos fora deste post, recomendo ler esta p\u00e1gina<\/a> na documenta\u00e7\u00e3o do Composer. Est\u00e1 fora do escopo do que estamos fazendo aqui, mas pode ser \u00fatil com outros trabalhos que voc\u00ea tem agora ou que far\u00e1 no futuro.<\/p>\n Se voc\u00ea estiver trabalhando no Boilerplate em sua m\u00e1quina local, poder\u00e1 ver algo assim:<\/p>\n Mas se voc\u00ea executar o comando inclu\u00eddo acima, ver\u00e1 algo assim:<\/p>\n Essa \u00e9 uma grande diferen\u00e7a e este \u00e9 um projeto pequeno. Imagine fazer algo muito maior que ser\u00e1 executado em produ\u00e7\u00e3o.<\/p>\n Falando por experi\u00eancia pr\u00f3pria, posso dizer que os projetos podem atingir rapidamente 20 MB ou mais de depend\u00eancias se voc\u00ea estiver usando uma variedade de bibliotecas de terceiros para coisas como log, solicita\u00e7\u00f5es HTTP e ferramentas de qualidade de c\u00f3digo.<\/p>\n As pessoas costumam dizer que voc\u00ea n\u00e3o deve incluir o diret\u00f3rio do fornecedor no controle de origem e por um bom motivo: pode ser enorme.<\/p>\n At\u00e9 a documenta\u00e7\u00e3o do Composer fala sobre isso:<\/a><\/p>\n A melhor pr\u00e1tica \u00e9 fazer com que todos os desenvolvedores usem o Composer para instalar as depend\u00eancias. Da mesma forma, o servidor de compila\u00e7\u00e3o, CI, ferramentas de implanta\u00e7\u00e3o, etc., devem ser adaptados para executar o Composer como parte da inicializa\u00e7\u00e3o do projeto.<\/p>\n<\/blockquote>\n ent\u00e3o o que devemos fazer? Precisamos do autoloader e precisamos de certas depend\u00eancias porque nossos usu\u00e1rios n\u00e3o saber\u00e3o rodar (nem deveriam rodar!) Composer sempre que baixarem nosso trabalho.<\/p>\n Por causa da natureza do WordPress e do trabalho que estamos fazendo, precisaremos confirmar o diret\u00f3rio do fornecedor, mas apenas com certos requisitos.<\/p>\n Ent\u00e3o vamos fazer cada passo e ver como fica quando terminarmos.<\/p>\n Para criar uma nova ramifica\u00e7\u00e3o de dentro do terminal, digite o seguinte comando<\/a> :<\/p>\n Isso pegar\u00e1 todo o c\u00f3digo no qual estamos trabalhando e criar\u00e1 uma nova ramifica\u00e7\u00e3o com ele. J\u00e1 que este ser\u00e1 o branch que usaremos para atuar como o que nossos usu\u00e1rios ir\u00e3o usar (falaremos sobre master<\/strong> em um post futuro).<\/p>\n Primeiro, revise seu arquivo composer.json e verifique se ele inclui o seguinte:<\/p>\n Agora precisamos ter certeza de que executamos o comando Composer acima para garantir que nada al\u00e9m do que precisamos esteja no diret\u00f3rio do fornecedor<\/strong>.<\/p>\n Agora precisamos atualizar o gitignore.<\/p>\n E se voc\u00ea acompanhou a s\u00e9rie e o post at\u00e9 aqui, sabe que ser\u00e1 algo assim (pode incluir mais ou menos, mas deve incluir pelo menos isso).<\/p>\n Para mim, isso se parece com o seguinte<\/a> :<\/p>\n Dependendo se voc\u00ea estiver usando um terminal ou um cliente, ver\u00e1 que h\u00e1 novos arquivos para confirmar (do diret\u00f3rio do fornecedor, especificamente). Portanto, adicione-os ao seu branch.<\/p>\n Em seguida, confirme suas altera\u00e7\u00f5es<\/a>. Voc\u00ea pode ter que especificar o seguinte se estiver trabalhando no terminal:<\/p>\n E com isso, seu c\u00f3digo deve funcionar e estar dispon\u00edvel no GitHub (ou em qualquer servi\u00e7o de controle de origem que voc\u00ea esteja usando). Voc\u00ea pode ver o que tenho dispon\u00edvel aqui<\/a>.<\/p>\n Agora que temos todas as pe\u00e7as necess\u00e1rias no lugar, \u00e9 hora de come\u00e7ar a usar o Composer, o autoloader, nossas classes abstratas e nosso Registry para come\u00e7ar a adicionar algumas funcionalidades b\u00e1sicas ao WordPress Widget Boilerplate para que tenhamos algo para mostrar em nosso trabalho .<\/p>\n Para quem est\u00e1 curioso, neste momento estou planejando manter as filiais organizadas assim:<\/p>\n Por enquanto, por\u00e9m, revise o que \u00e9 abordado nesta postagem e retomaremos isso na pr\u00f3xima postagem.<\/p>\nThe WordPress Widget Boilerplate: Refatora\u00e7\u00e3o, Parte 6<\/h2>\n
O Autoloader Definido<\/h3>\n
\n
vendor\/autoload.php<\/code>arquivo. Voc\u00ea pode simplesmente incluir este arquivo e come\u00e7ar a usar as classes que essas bibliotecas fornecem sem nenhum trabalho extra:<\/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
Ainda interessado?<\/h4>\n
Como \u00e9 essa apar\u00eancia no Boilerplate?<\/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>\nIncluiremos em nosso diret\u00f3rio de fornecedores?<\/h2>\n
\n
\n
Criando a ramifica\u00e7\u00e3o de lan\u00e7amento<\/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>\nAtualizando o que ignoramos<\/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>\nAdicionando Funcionalidade<\/h2>\n
\n