php - hashtags - hashtag list




Posso usar o sinal de hash(#) para comentar em PHP? (7)

Existe alguma razão, além da preferência pessoal, para usar // em vez de # para comentários?

Eu acho que é apenas uma preferência pessoal. Não há diferença entre // e # . Eu pessoalmente uso # para comentário de uma linha, // para comentar código e /** */ para comentário de bloco.

<?php
    # This is a one-line comment
    echo 'This is a test';

    // echo 'This is yet another test'; // commenting code

    /** 
     * This is a block comment
     * with multi-lines 
     */
    echo 'One final test';
?>

Eu nunca, nunca, vi um arquivo PHP usando hashes ( # ) para comentar. Mas hoje eu percebi que eu realmente posso! Estou assumindo que há uma razão pela qual todo mundo usa // invés disso, então aqui estou eu.

Existe alguma razão, além da preferência pessoal, para usar // vez de # para comentários?


Não há PSR oficial para isso.

No entanto, em todos os códigos de exemplo do PSR, eles usam // para comentários in-line.

Há uma proposta de extensão do PSR-2 que visa padronizá-lo, mas não é oficial: https://github.com/php-fig-rectified/fig-rectified-standards/blob/master/PSR-2-R-coding-style-guide-additions.md#commenting-code

// é mais comumente usado na cultura PHP, mas é bom usar # também. Eu pessoalmente gosto disso, por ser mais curto e salvar bytes. É um gosto pessoal e tendencioso, não há resposta certa para isso, até que, é claro, isso se torne um padrão, algo que devemos tentar seguir o máximo possível.


A resposta para a pergunta Existe alguma diferença entre usar "#" e "//" para comentários de linha única no PHP? é não .

Não há diferença. Observando a parte de análise do código-fonte do PHP, tanto "#" quanto "//" são manipulados pelo mesmo código e, portanto, têm exatamente o mesmo comportamento.


Comentários com "#" estão obsoletos com o PHP 5.3. Então sempre use // ou / ... /


Se você estabelecer alguns conjuntos de regras em sua equipe / projeto ... os dois tipos de comentários podem ser usados ​​para descrever o propósito do código comentado.

Por exemplo, eu gosto de usar # para desativar / desativar configurações, subfunções e, em geral, um código útil ou importante, mas que está atualmente desativado.


Sim, no entanto, existem diferenças entre plataformas.

Eu uso # o tempo todo para comentar em PHP, mas notei uma diferença de adoção.

No teclado do Windows, a tecla # é fácil de usar. No mac teclado # chave principalmente não está presente.

Portanto, para usuários do Mac, [Alt] + [3] ou [⌥] + [3] é mais difícil de digitar do que //, então // tornou-se uma maneira multiplataforma de exibir código com comentários.

Esta é minha observação.


<?php
    echo 'This is a test'; // This is a one-line C++ style comment
    /* This is a multi-line comment.
       Yet another line of comment. */
    echo 'This is yet another test.';
    echo 'One Final Test'; # This is a one-line shell-style comment
?>

RTM





comments