Bibliotecas para plugins do WordPress, parte 2
Ontem, eu comecei uma pequena série de posts cobrindo ferramentas que eu acho que fazem para escrever código de alta qualidade em um projeto WordPress (especificamente aqueles que são plugins construídos usando uma abordagem orientada a objetos).
Se você não leu o post, o primeiro conjunto de ferramentas mencionado é o seguinte:
Existem cerca de mais cinco ferramentas que eu gosto de manter em execução em meus projetos. Então aqui estão os próximos três com os dois finais vindo no próximo post.
Bibliotecas para plugins do WordPress, continuação
Como mencionado anteriormente, acho essas ferramentas úteis sempre que estou trabalhando em plugins WordPress orientados a objetos. Além disso, eles são naturalmente espalhados por alguns posts para manter cada um curto e focado.
PHP CodeSniffer
Se você está lendo este blog há algum tempo, provavelmente já leu um post ou pelo menos mencionou algo sobre PHP CodeSniffer. Isso é algo que eu acho que, se nada mais, todo desenvolvedor WordPress deveria ter instalado em seu IDE.
Na página do repositório do projeto:
PHP_CodeSniffer tokeniza arquivos PHP, JavaScript e CSS e detecta violações de um conjunto definido de padrões de codificação.
Agora, em relação às regras, isso é uma coisa diferente. Algumas pessoas preferem os Padrões de Codificação do WordPress ; alguns preferem PSR2, alguns preferem outros conjuntos de regras. Não é tanto sobre o que você prefere, desde que você ou sua equipe sejam consistentes.
E é isso que essa biblioteca específica ajuda você a fazer. Além disso, não faz mal que você possa integrá-lo ao seu IDE (supondo que seja um dos editores mais populares).
PHPCPD
PHPCPD é uma biblioteca simples que analisa seu código para detectar código duplicado – que geralmente vem de ser copiado e colado de outro lugar (mesmo que seja sua base de código). A ideia por trás da biblioteca é reduzir o código duplicado.
E não fica muito mais claro do que isso :
phpcpd é um Detector de Copiar/Colar (CPD) para código PHP.
Em outras palavras, é um passo para ajudá-lo a mantê-lo SECO.
PHPMND
Se um dos objetivos que buscamos em nosso código é torná-lo o mais legível possível por outras pessoas que possam pegar a base de código, bifurcá-la ou contribuir com ela (especialmente em código aberto), então precisamos ter certeza de que todos dos nossos valores têm valores significativos.
Usar números que são significativos para nós, mas não descrevem o que o código está fazendo é importante, mas não é algo que fazemos, certo? Ou talvez seja só eu.
Mas é aí que o PHPMND entra em cena.
phpmnd é uma ferramenta que ajuda a detectar números mágicos no código PHP. Por padrão, 0 e 1 não são considerados números mágicos.
É uma biblioteca simples, mas usada em conjunto com as bibliotecas deste post, e o post anterior pode ajudar a aumentar continuamente a qualidade do código que você está contribuindo para seus repositórios.
Mais um conjunto de ferramentas
Conforme mencionado no post anterior, o objetivo com o qual estou trabalhando é como incorporar tudo isso em um composer.jsonarquivo que você possa usar em seu projeto.
Lembre-se também que, dependendo do projeto, pode ser necessário selecionar uma versão da biblioteca com base na versão do PHP que você está usando.