PHP - Padrão de Codificação
Cada empresa segue um padrão de codificação diferente com base em suas melhores práticas. O padrão de codificação é necessário porque pode haver muitos desenvolvedores trabalhando em módulos diferentes, portanto, se eles começarem a inventar seus próprios padrões, o código-fonte se tornará muito difícil de gerenciar e será difícil manter esse código-fonte no futuro.
Aqui estão várias razões pelas quais usar especificações de codificação -
Seus programadores pares precisam entender o código que você produz. Um padrão de codificação atua como o projeto para toda a equipe decifrar o código.
A simplicidade e a clareza alcançadas por uma codificação consistente evitam erros comuns.
Se você revisar seu código depois de algum tempo, será fácil entendê-lo.
Seu padrão da indústria é seguir um determinado padrão para obter mais qualidade em software.
Existem algumas diretrizes que podem ser seguidas durante a codificação em PHP.
Indenting and Line Length- Use um recuo de 4 espaços e não use nenhuma guia porque computadores diferentes usam configurações diferentes para a guia. É recomendável manter as linhas com aproximadamente 75-85 caracteres para melhor legibilidade do código.
Control Structures- Incluem if, for, while, switch, etc. As instruções de controle devem ter um espaço entre a palavra-chave de controle e o parêntese de abertura, para distingui-las das chamadas de função. Recomendamos que você sempre use chaves, mesmo em situações em que são tecnicamente opcionais.
Examples
if ((condition1) || (condition2)) {
action1;
}elseif ((condition3) && (condition4)) {
action2;
}else {
default action;
}
Você pode escrever instruções switch da seguinte forma -
switch (condition) {
case 1:
action1;
break;
case 2:
action2;
break;
default:
defaultaction;
break;
}
Function Calls- As funções devem ser chamadas sem espaços entre o nome da função, o parêntese de abertura e o primeiro parâmetro; espaços entre vírgulas e cada parâmetro, e nenhum espaço entre o último parâmetro, o parêntese de fechamento e o ponto-e-vírgula. Aqui está um exemplo -
$var = foo($bar, $baz, $quux);
Function Definitions - As declarações das funções seguem o "estilo BSD / Allman" -
function fooFunction($arg1, $arg2 = '') {
if (condition) {
statement;
}
return $val;
}
Comments- Comentários de estilo C (/ * * /) e comentários C ++ padrão (//) são adequados. O uso de comentários de estilo Perl / shell (#) é desencorajado.
PHP Code Tags- Sempre use <? Php?> Para delimitar o código PHP, não o <? ?> taquigrafia. Isso é necessário para a conformidade do PHP e também é a maneira mais portátil de incluir código PHP em diferentes sistemas operacionais e configurações.
Variable Names -
- Use todas as letras minúsculas
- Use '_' como separador de palavras.
- Variáveis globais devem ser precedidas de um 'g'.
- As constantes globais devem ser todas em maiúsculas com separadores '_'.
- Variáveis estáticas podem ser anexadas a 's'.
Make Functions Reentrant - As funções não devem manter variáveis estáticas que evitem que uma função seja reentrada.
Alignment of Declaration Blocks - Bloco de declarações deve ser alinhado.
One Statement Per Line - Deve haver apenas uma instrução por linha, a menos que as instruções estejam intimamente relacionadas.
Short Methods or Functions - Os métodos devem se limitar a uma única página de código.
Pode haver muitos outros pontos que devem ser considerados ao escrever seu programa PHP. Acima de tudo, a intenção deve ser ser consistente em toda a programação do código e isso só será possível quando você seguir qualquer padrão de codificação. Você pode usar seu próprio padrão se quiser algo diferente.