Olá pessoal, tudo certo?
Gostaria de escrever sobre uma ferramenta que considero super importante estar presente na sua stack de desenvolvimento PHP.
Estou falando do já conhecido PHP Coding Standard Fixer, o PHP CS Fixer.
Sobre a ferramenta:
O objetivo do PHP CS Fixer é aplicar os padrões básicos de codificação e estilo de código nos arquivos PHP do seu projeto.
Ele detecta o código fora dos padrões e aplica um “fix”, transformando essas ocorrências em código que segue as recomendações atuais de codificação da linguagem definidas pelo PHP-FIG.
Instalação:
composer require --dev friendsofphp/php-cs-fixer
Uso:
Considere o script abaixo:
Nele encontramos alguns trechos que não estão de acordo com os padrões definidos nas PSR 1 e PSR 2, entre eles:
- Sempre incluir uma linha em branco entre a declaração do namespace e as declarações “use”
- Nunca utilizar a palavra “var” e sempre declarar a visibilidade para propriedades
- Sempre declarar a visibilidade para métodos
- O “final” deve preceder a declaração de visibilidade, não existe espaço entre o nome do método e o parêntese de abertura e a chave de abertura deve estar posicionada na próxima linha com o recuo adequado
Estes são somente alguns exemplos de “infrações” das recomendações atuais que podem ser corrigidos pela ferramenta.
E agora, vamos resolver?
Para isso, basta rodar o seguinte comando apontando para o arquivo / diretório que você deseja afetar:
php vendor/bin/php-cs-fixer fix PdfGenerator.php
Resultado:
Como podemos verificar, todas as inconsistências de escrita foram detectadas e resolvidas de forma muito rápida e eficiente!
Observações:
Por default o PHP CS Fixer aplica a PSR 1 e PSR 2 em suas detecções, mas podemos definir regras personalizadas concatenando-as no próprio comando ou em um arquivo de configuração.
Para ver todos os detalhes, cobertura e possibilidades de uso da ferramenta, recomendo fortemente que visite a página do projeto através deste link.
Conclusão:
Sem dúvidas o PHP Coding Standard Fixer é uma excelente ferramenta de auxílio para devs PHP, executando a detecção e correção de código fora dos padrões recomendados pela comunidade, e assim, contribuindo com o desenvolvimento de projetos manuteníveis.
Espero este post tenha sido útil para você!
Forte abraço!