{"id":231800,"date":"2022-12-29T18:22:00","date_gmt":"2022-12-29T15:22:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=231800"},"modified":"2022-12-29T18:22:56","modified_gmt":"2022-12-29T15:22:56","slug":"escrevendo-um-codigo-wordpress-melhor-phpstan","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/escrevendo-um-codigo-wordpress-melhor-phpstan\/","title":{"rendered":"Escrevendo um c\u00f3digo WordPress melhor: PHPStan"},"content":{"rendered":"\n

No post mais recente desta s\u00e9rie (que \u00e9 reconhecidamente h\u00e1 algum tempo), falei longamente sobre o Composer<\/a> e seu arquivo de bloqueio.<\/a><\/p>\n

Eu recomendo a leitura dos dois artigos anteriores porque o Composer eventualmente desempenhar\u00e1 um papel neste material que este e os pr\u00f3ximos posts compartilhar\u00e3o. Mas se voc\u00ea optar por n\u00e3o alcan\u00e7\u00e1-los (ou j\u00e1 estiver familiarizado com o Composer), a ess\u00eancia dos posts anteriores \u00e9, respectivamente, a seguinte:<\/p>\n

\n

Eu n\u00e3o recomendo verificar o diret\u00f3rio do fornecedor em seu reposit\u00f3rio. Isso pode se tornar um diret\u00f3rio enorme mais tarde, e pode minar todo o prop\u00f3sito do Composer.<\/p>\n

Compositor<\/a><\/p>\n

O objetivo \u00e9 garantir que todos estejam executando a mesma vers\u00e3o das depend\u00eancias do projeto \u2013 nem vers\u00f5es mais antigas, nem vers\u00f5es mais recentes \u2013 mas a mesma vers\u00e3o.<\/p>\n

O arquivo de bloqueio do compositor<\/a><\/p>\n<\/blockquote>\n

Com isso dito, existem in\u00fameras depend\u00eancias ou pacotes que podemos instalar que nos ajudam a ter certeza de que estamos escrevendo o c\u00f3digo da mais alta qualidade poss\u00edvel.<\/p>\n

Claro, alguns deles podem estar na forma de algo como padr\u00f5es de codifica\u00e7\u00e3o, mas essas s\u00e3o realmente mais regras do que elementos de escrita de c\u00f3digo de alta qualidade (embora eu n\u00e3o ache que devam ser deixados de fora da discuss\u00e3o – apenas deixados de fora neste momento \ud83d\ude43).<\/p>\n

De volta \u00e0s ferramentas em quest\u00e3o: Quais s\u00e3o algumas ferramentas que ajudam a escrever c\u00f3digo WordPress de alta qualidade? Vou compartilhar alguns dos meus favoritos e falarei sobre como podemos execut\u00e1-los em uma base de c\u00f3digo.<\/p>\n

Primeiro, vamos dar uma olhada na an\u00e1lise est\u00e1tica com PHPStan<\/a>.<\/p>\n

Melhor c\u00f3digo WordPress com PHPStan<\/h2>\n

O que \u00e9 an\u00e1lise est\u00e1tica, afinal?<\/h3>\n

Primeiro, algumas palavras sobre an\u00e1lise est\u00e1tica. Ou seja, o que \u00e9? \u00c9 um bocado, por um lado:<\/p>\n

\n

A an\u00e1lise de c\u00f3digo est\u00e1tico (tamb\u00e9m conhecida como an\u00e1lise de c\u00f3digo-fonte) geralmente \u00e9 realizada como parte de uma revis\u00e3o de c\u00f3digo (tamb\u00e9m conhecida como teste de caixa branca) e \u00e9 realizada na fase de implementa\u00e7\u00e3o de um ciclo de vida de desenvolvimento de seguran\u00e7a (SDL).<\/p>\n

An\u00e1lise de c\u00f3digo est\u00e1tico geralmente se refere \u00e0 execu\u00e7\u00e3o de ferramentas de an\u00e1lise de c\u00f3digo est\u00e1tico que tentam destacar poss\u00edveis vulnerabilidades no c\u00f3digo-fonte ‘est\u00e1tico’ (n\u00e3o em execu\u00e7\u00e3o) usando t\u00e9cnicas como an\u00e1lise de contamina\u00e7\u00e3o e an\u00e1lise de fluxo de dados.<\/p>\n

An\u00e1lise de c\u00f3digo est\u00e1tico via OWASP<\/a><\/p>\n<\/blockquote>\n

Pense desta forma: \u00e9 uma maneira de analisar um programa em busca de poss\u00edveis erros que voc\u00ea pode n\u00e3o ver ao trabalhar na base de c\u00f3digo.<\/p>\n

Ou seja, existem problemas, bugs, problemas de seguran\u00e7a, que podem estar presentes, mas voc\u00ea n\u00e3o pode detectar por v\u00e1rios motivos (o m\u00ednimo \u00e9 que voc\u00ea est\u00e1 muito pr\u00f3ximo do c\u00f3digo).<\/p>\n

Com o tempo, por\u00e9m, a comunidade de desenvolvimento aprendeu maneiras de analisar o c\u00f3digo, gerar conjuntos de regras e criar ferramentas para ajudar a encontrar exatamente todos os itens acima.<\/p>\n

An\u00e1lise est\u00e1tica do c\u00f3digo centrado no WordPress<\/h3>\n

E \u00e9 aqui que o PHPStan entra em cena.<\/p>\n

\"Escrevendo<\/a><\/p>\n

Como mencionado, o objetivo do pacote \u00e9 identificar erros ou bugs que existem em seu c\u00f3digo antes que seu c\u00f3digo seja usado por algu\u00e9m que n\u00e3o seja desenvolvedores, destac\u00e1-los e dar a voc\u00ea a oportunidade de corrigi-los.<\/p>\n

Como ferramentas como essa examinam uma base de c\u00f3digo (em vez de executar o c\u00f3digo), nem sempre \u00e9 poss\u00edvel obter uma imagem clara. Isso significa que podemos obter falsos positivos.<\/p>\n

Mais sobre isso em um momento embora.<\/p>\n

Se voc\u00ea estiver interessado em come\u00e7ar a executar o PHPStan em sua base de c\u00f3digo, \u00e9 f\u00e1cil. Depois de instal\u00e1-lo, lembre-se de configur\u00e1-lo para que n\u00e3o olhe no vendor<\/code>diret\u00f3rio ou, digamos, no n\u00facleo do WordPress.<\/p>\n

Em vez disso, fa\u00e7a com que ele examine seu c\u00f3digo.<\/p>\n

Instalando o PHPStan<\/h3>\n

Primeiro, em seu composer.json<\/code>arquivo, adicione a seguinte linha na require-dev<\/code>se\u00e7\u00e3o:<\/p>\n

\"phpstan\/phpstan\": \"^0.11.12\"<\/code><\/p>\n

Em seguida, execute composer update<\/code>no seu terminal.<\/p>\n

Uma vez instalado, voc\u00ea pode execut\u00e1-lo em um arquivo individual, um diret\u00f3rio ou um conjunto de diret\u00f3rios. Se voc\u00ea leu meus posts anteriores sobre organiza\u00e7\u00e3o de c\u00f3digo, sabe que sou f\u00e3 de manter a maior parte do c\u00f3digo-fonte do projeto src<\/code>para que voc\u00ea possa executar algo assim:<\/p>\n

$ vendor\/bin\/phpstan analyse src<\/code><\/p>\n

Isso gerar\u00e1 sa\u00edda com base no que o utilit\u00e1rio encontrar.<\/p>\n

Lembra mais cedo quando eu disse que pode encontrar coisas como falsos positivos? Aqui est\u00e1 uma an\u00e1lise mais detalhada do que voc\u00ea pode ver:<\/p>\n