~ O Blog de 1999 ~

Dicas de PHP que me poupam tempo todas as semanas

Escrevo PHP há anos, e alguns hábitos fazem uma diferença real. Não são truques sofisticados. São coisas pequenas que previnem bugs, tornam o código mais fácil de ler e poupam tempo quando algo corre mal.

1. Usa tipos estritos

Adiciona declare(strict_types=1); no topo de cada ficheiro PHP. Impede o PHP de converter tipos silenciosamente, o que apanha toda uma classe de bugs antes de chegarem a produção. É uma linha que poupa horas de depuração.

2. Especifica os tipos nas assinaturas das funções

Declara sempre os tipos dos parâmetros e dos valores de retorno. function getUser(int $id): ?User diz-te exatamente o que uma função espera e devolve. Torna o código autodocumentado e deixa o teu IDE apanhar erros cedo.

3. Usa null coalescing em vez de isset

Em vez de isset($arr['key']) ? $arr['key'] : null, escreve $arr['key'] ?? null. É mais curto, mais claro e faz o mesmo trabalho. Para valores aninhados, usa o operador null coalescing em cada nível.

4. Nunca confies na entrada do utilizador

Sanitiza e valida tudo o que vem de um formulário, de um URL ou de uma API. Usa prepared statements para consultas à base de dados, escapa a saída e valida contra uma lista de permitidos quando puderes. É a diferença entre uma app segura e uma vulnerável.

5. Usa exceções, não códigos de erro

Quando algo pode falhar, lança uma exceção em vez de devolver false ou um código de erro. As exceções trazem uma mensagem e um stack trace, o que torna a depuração muito mais fácil. Apanha-as no nível certo e regista os detalhes.

6. Escreve funções pequenas

Uma função deve fazer uma coisa. Se uma função está a fazer três coisas, divide-a. Funções pequenas são mais fáceis de testar, de ler e de reutilizar. É a forma mais simples de manter uma base de código sustentável.

7. Regista, não faças echo

Ao depurar, usa um logger em vez de echo ou var_dump. Fazer echo parte a tua saída e é fácil de esquecer. Um logger mantém o teu código limpo e deixa um registo que podes verificar mais tarde.

A versão curta

Tipos estritos, assinaturas com tipos, null coalescing, validação de entrada, exceções, funções pequenas e registo adequado. Estes sete hábitos tornam o código PHP mais seguro, mais claro e mais fácil de manter. Começa com um e constrói a partir daí.