Por que o código do Wordpress é tão "feliz no espaço"?

22

O núcleo do WP, muitos plugins do WP e os padrões de codificação do WP a> use uma aplicação muito generosa do caracter Espaço (não para recuo, mas "dentro" de parênteses e colchetes). Isso parece ser exclusivo do Wordpress - esse estilo / filosofia não parece estar presente em outros projetos similares, PHP ou outros.

Para mais informações sobre essa abordagem, veja: enlace

Exemplo: foreach ( (array) $foo as $bar ) { ...

Estou me referindo ao espaço após foreach, após o primeiro ( e antes do final ) (e outros espaços semelhantes mostrados em "Space Usage" no link acima).

Esse estilo parece desnecessário para mim - requer mais digitação e (opinião) torna o código de análise visualmente mais difícil. (/ opinião)

O meu desejo não é para debater se este estilo é ou não uma boa ideia. Em vez disso, eu simplesmente quero entender os motivos para por que este é o estilo recomendado. Até mesmo comentaristas sobre os padrões de codificação do WP são curiosos:

AsrespostasfornecidasàperguntadeMKSafisãoessencialmente:

  1. Porlegibilidade
  2. Statusquo(tambémconhecidocomo"É assim que é")

Meu raciocínio por perguntar é que eu pessoalmente não vejo muito valor em adotar os padrões de codificação do WP (em relação ao "uso do espaço") em nossos projetos internos. No entanto, estou curioso para saber se estou perdendo alguma coisa.

Existem outras razões além das duas listadas acima, aparentemente válidas ou não, para seguir o estilo "Uso de espaço" do Wordpress?

    
por rinogo 08.01.2015 / 01:52
fonte

2 respostas

12

Ressoando

Em relação a "espaço em branco" (não importa se guias ou espaços): é simplesmente uma preferência pessoal que ficou com o projeto.

Os padrões de codificação do WP são uma bagunça e podem ser ignorados - contanto que você não esteja contribuindo para o núcleo, que é

  • uma história diferente e
  • O
  • guia de estilo também é ignorado.
  

"[...] ele não é aplicado retroativamente em massa em código antigo, pois torna o histórico do svn / git muito difícil de usar. A política oficial é que o novo código deve seguir o guia de estilo, mas se você Por acaso, para formatar o código adjacente corretamente, então assim seja, mas os patches que apenas formatam o código, ou confirma que apenas o formato do código é proibido. "

     

- @TomJNowell nos comentários

Alternativas

É melhor seguir os padrões PSR (a saber: 2) ou coisas como os padrões do Symfony (ou apenas o seu próprio).

Aumento de desempenho & Ferramentas

Não há lucro que você tenha de ter um padrão de codificação (além de ter um para compartilhar e a minoria que odeia isso, enquanto o resto o determina) ou de ter mais ou menos guias ou espaços. Caso esteja preocupado com o uso desnecessário de espaço em disco ou com programas mais lentos, ainda é possível compactar seu código (consulte o projeto GitPHPHooks ) no commit. O benefício que você obterá será em torno de max 5% do espaço de arquivo original, praticamente igual ao que a compactação / redução de sintaxe HTML oferece. Existem Node.js ferramentas de minimização disponíveis via npm para isso.

O que eu pessoalmente acho realmente útil é o PHP Linter e o _PHP Mess Detector. Eu incorporei ambos na Biblioteca do GitPHPHooks , para que não precise pensar ou se preocupar com a execução.

    
por kaiser 08.01.2015 / 03:45
fonte
7

Espaços após pontos são normais, como $baz . '-5' , esse estilo é usado em muitos padrões de codificação para operadores ( y + z ).

Isso é feito para melhorar a legibilidade, por exemplo, um deles é mais legível que o outro.

$cow.$dog.$cat.$table.$chocolate.$puddle.$iterator.$stuctureone.$stucturetwo

$cow . $dog . $cat . $table . $chocolate . $puddle . $iterator . $stuctureone . $stucturetwo

Isso se torna ainda mais óbvio quando cercado por outro "código".

Quanto aos espaços em torno do parêntese ( 1, 2, 3 ) Não faço ideia, acho que o argumento também é de legibilidade.

Pode ser confuso, pois os próprios padrões do WordPress exemplos com parênteses em comentários que não têm espaços e a base de código em si é confusa, com algumas partes tendo espaços e outras não (ver captura de tela abaixo), mesmo dentro da mesma função.

A maioria dos padrões PHP realmente faz o oposto, uma chamada para .. parênteses devem abraçar seu conteúdo. Na verdade, a maioria dos padrões de codificação para outras linguagens escreve: (1, 2, 3) , então é um mistério por que WP faz isso dessa maneira?

Aqui está um exemplo para comparar com uma função do WordPress.

Versãomaiorparacomparar: enlace

Eu prefiro o da direita, especialmente ao olhar para uma tela cheia de código, mas é uma preferência pessoal.

    
por Wyck 08.01.2015 / 05:04
fonte