PHP – Fundamentos Básicos

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ários motivos pelos 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.
• Recuo e comprimento da linha – 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.
• Estruturas de controle – 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.

Exemplos:

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;
}

• Chamadas de função – 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);

• Definições de função – as declarações de função seguem o “estilo BSD / Allman”

function fooFunction($arg1, $arg2 = '') {
   if (condition) {
      statement;
   }
   return $val;
}

• Comentários – comentários de estilo C (/ * * /) e comentários padrão C ++ (//) são adequados. O uso de comentários de estilo Perl / shell (#) é desencorajado.
• Tags de código PHP – sempre use <? Php?> Para delimitar o código PHP, nã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.
• Nomes de Variáveis –
  • 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’.
• Tornar funções reentrantes – as funções não devem manter variáveis estáticas que evitam que uma função seja reentrante.
• Alinhamento de blocos de declaração – o bloco de declarações deve ser alinhado.
• Uma instrução por linha – deve haver apenas uma instrução por linha, a menos que as instruções estejam intimamente relacionadas.
• Métodos ou funções curtas – 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.