Práticas
- Nunca usar tabulação nos códigos. A indentação é sempre feita com 2 espaços em branco.
- Não colocar espaços depois de abrir e fechar parenteses.
if ($reqvalue _getRequestValue($name)) correto
if ( $reqvalue _getRequestValue($name) ) incorreto
- Usar camelCase, e não underscores, para variáveis, funções e nomes de métodos, exeto para nomes de helpers.
- Chaves sempre tem uma linha única só para elas.
- Não termine arquivos de bibliotecas (lib/) com o tradicional ?>. Ele na verdade não é obrigatório e caso venha a ter algum espaço depois (”?> “) ocorrerá erro.
- No corpo das funções é bom que o “return” tenha um destaque para melhorar a leitura. Para isso, deixe uma linha em branco antes dele.
function fooFunction() {
if (condition2 || condition3) {
statement1;
statement2;
return 1;
} else {
defaultaction;
}
return null;
}
- Os comentarios de uma linha devem vir sempre desse jeito
// primeiro espaço, sem quebra de linha se ficar longo`
- Evitar de tratar variáveis dentro de strings.
$string = ‘algo’;
$new_string = "$string é legal!"; // ruim
$new_string = $string . ‘ é legal!’; // melhor
Lucas | 14-Feb-08 at 5:53 am | Permalink
“- Nunca usar tabulação nos códigos. A indentação é sempre feita com 2 espaços em branco.”
De acordo com padrao PEAR RFC deve ser usado 4 espacos e nenhum tipo de tab no codigo.
Eu pessoalmente discordo e continuo usando tabs, de qualquer tamanho nos meus codigos. Com isso meus codigos ficam mais leves, ou seja, mais rapido para fazer upload, parse, download, etc. E tambem tem a vantagem que usando tabs voce pode “reformatar” automaticamente qualquer codigo para suas preferencias, em qualquer editor.
Pedro | 14-Feb-08 at 10:04 am | Permalink
@Lucas: Eu prefiro usar 4 espaços sem tab, mas todas as libs, core, etc do symfony são feitas com 2 espaços sem tabs. Eu acho que isso é um pouco pessoal também, cada um visualiza melhor de um jeito.
g0dbrz | 29-May-08 at 12:08 pm | Permalink
Nem todos os editores intentam o tab de forma semelhante e da pra reformatar o código usando apenas espaços no lugar do tab