Quando aprendemos a programar o nosso foco é fazer o código funcionar. Nessa fase é normal adquirir um estilo de codificação que mistura um pouco de todo material didático consumido. E não tentamos entender os motivos de como foi escrita cada linha de código, porque o código foi identado de tal maneira, porque os nomes das classes, métodos ou propriedades foram escritas de tal forma, etc…

Os problemas aparecem quando começamos a programar profissionalmente e temos contato com o código de outros programadores. Como cada um trilha seu próprio caminho de aprendizado é comum haver variações de estilo entre programadores.

Nesse cenário ocorre dificuldade de compreensão do código compartilhado entre programadores, seja entre um time, entre comunidades ou terceiros. Como cada um tem seu próprio estilo é como se dentro da linguagem houvessem várias linguagens; o meu PHP é diferente do seu PHP que é diferente do PHP do framework da moda, e assim por diante.

O que são PHP Standards Recomendations – PSR?

Para resolver essa falta de padronização e tentarmos unificar estilos de programação é que surgiram algumas iniciativas dentro das próprias comunidades das linguagens. No caso do PHP foi criado o PHP-FIG.

Com o lançamento do PHP 5 por volta de 2005 houve uma proliferação de frameworks PHP opensource. E cada framework usando um estilo e padrões próprios o que dificultava muito o aprendizado de vários frameworks.

Em 2009 foi criado o PHP Framework Interop Group (PHP-FIG), um grupo de pessoas representantes dos frameworks engajados na causa de avaliar as melhores práticas de programação e estilos adotados entre eles e definir recomendações que poderiam ser seguidas por qualquer programador, as chamadas PHP Standards Recomendations (PSRs).

Para adotar as PSRs basta ler as 18 recomendações (até o momento) que estão disponíveis gratuitamente e implementa-las no código. Pode ser bem desmotivador pensar em rever todas as classes, métodos, propriedades e linhas do software.

Mas para acelerar o processo de adoção das PSRs existe uma ferramenta chamada PHP CodeSniffer que varre nosso código e indica os pontos que não seguem as PSRs. E ainda se não bastasse, ela possui um comando que corrige algumas dessas inconsistências mais comuns.

É uma mão na roda para o time que desenvolve em PHP começar a seguir padrões e estilos que tornarão seu trabalho muito mais organizado, compreensível e profissional. Podemos usar a ferramenta a medida em que vamos nos adaptando aos novos padrões de maneira gradativa sem impactar no fluxo de trabalho.

Eu gravei esse vídeo explicando como podemos usar o PHP CodeSniffer para colocar nosso software em conformidade com as PSRs.

A importância de adotar padrões e estilo de programação.

Acredito que após aprendermos a programar, o segundo passo mais importante deveria ser aprendermos como escrever códigos com mais clareza e de mais fácil compreensão. É quando devemos começar a nos preocupar com os padrões e estilos de programação.

Adotar padrões nos permite compreender melhor o código da equipe, de terceiros, de comunidades que adotam os mesmos padrões e também permite que os demais compreendam melhor o que nós escrevemos.

Entender que o código que nós escrevemos é para outro humano compreender e não só para o computador executar operações é um passo importante para subirmos nosso nível de senioridade como programadores.