Почему использование комментариев "#" часто не рекомендуется на PHP?

Насколько я знаю, существует 3 типа комментариев, распознаваемых PHP:

  • /* A block comment */
  • // A single-line comment
  • # Also a single-line comment

Однако многие стандарты кодирования, например, PEAR или Kohana, отмените комментарий последнего типа без объяснения причин. Вопрос в том, почему это так? Является ли этот синтаксис запланированным для устаревания в ближайшее время?

Ответы

Ответ 1

Стиль комментариев на языке C стал отраслевым стандартом. Нет ничего плохого в использовании комментариев # вообще, если конкретный стандарт кодирования для вашего проекта или рабочего места не запрещает его. Стандарты - это ключ к получению читаемого кода.

Во многих случаях // и/или /* */ считаются стандартным синтаксисом комментариев для языков программирования. Единственным исключением, которое обычно встречается, является VB, который использует '. Напротив, # часто считается стандартным синтаксисом комментариев для сценариев оболочки.

PHP был разработан для выполнения обеих задач изначально. PHP может и достаточно хорошо работает, как язык сценариев оболочки, и может быть вызван из командной строки. Он имеет функции для обработки чтения из stdin и записи в stdout. Вероятно, это источник синтаксиса # для комментариев. #, вероятно, обескуражен, поскольку в настоящее время PHP рассматривается как язык программирования, а не инструмент для сценариев оболочки. В частности, стиль руководства, что ссылки на вопросы для веб-приложений, а не какой-либо инструмент оболочки.

Ответ 2

Из опубликованных вами ссылок это выглядит как чисто стилистический выбор. PEAR и Kohana хотели бы иметь некоторое единство, когда дело доходит до стиля, и у них есть (возможно, произвольно), выбранный, чтобы предпочесть комментарии C-Style к файлам UNIX/Perl.

Ответ 3

возможно//и/* */также являются комментаторами для многих других языков, таких как c, С++, С#, javascript, css и многие другие. поэтому, возможно, люди привыкли к их использованию. просто гадать.

Ответ 4

Я бы подумал, потому что многие другие программные блокировки используют//как один комментарий линии (C, С++, С#, java, ect..), и PHP получает много своего синтаксиса с C-подобных языков.

Я не верю, что в ближайшее время # будет устаревшим.

Ответ 5

Единственная причина, по которой я могу думать, это то, что было бы больно читать код, чтобы иметь два разных вида синтаксиса однострочных комментариев, плавающих вокруг.//кажется более распространенным способом, поэтому я предполагаю, что они просто пытаются ограничить себя, чтобы повысить читаемость

Ответ 6

Форма комментария # в PHP не рекомендуется руководствами стиля PECL, но по-прежнему приемлема и, вероятно, не будет устаревать. аналогично тому, что имена классов обычно не имеют в них чисел. это просто соглашение