// コメントの後ろのスペースの有無について言及したコーディング規約はありますか？

Question

PHP のコメントで//を使う場合、//の後ろにはスペース入れるものですか？入れないものですか？　主要なコーディング規約で言及されているものがあれば知りたいです。

// コメント

or

//コメント

PSR のページ見るとサンプルは前者で書かれていますが、特に言及されている箇所は見つけられなかったです。
当たり前すぎるのか、特にルールはないのか。(言及されているけれど見つけられてないだけか)
記事サイトなどは前者が多いですが、後者で書いている人もたまに見かけます。

言及されている規約がある場合は教えていただけますとありがたいです。
よろしくお願いいたします。

Answer 1

PHPではありませんが、PythonのスタイルガイドPEP 8では、#とスペース1つで始めるべき、とあります。

• はじめに — pep8-ja 1.0 ドキュメント
• PEP 8 -- Style Guide for Python Code | Python.org

言語仕様としては、コメント開始トークンの後のスペースはoptionalであり、requiredではありませんが、コメントの可読性を向上させるため、また「コードの一時的なコメントアウト」ではなく「説明としてのコメント」であることを明らかにするためにも、スペースを入れるように規定しているのだと思われます。

Answer 2

私が調べた限りだと、PHP の行コメント // の後にスペースを入れるかについて明示的に書かれた有名なコーディング規約はありませんでした。

PHP の標準的なコーディング規約には PHP Standard Recommendation (PSR) に含まれる PSR-1, PSR-2, PSR-4 および PSR-12 がありますが、これらはコメントの仕方には言及していません。PSR を作っている団体のメーリングリストも覗いて見ましたが、ドキュメント用コメントについての議論以外は見当たりませんでした。

その他だと、PHP で書かれたソフトウェアで採用されているコーディング規約があります。Qiita の記事「PHPコーディング規約まとめ」が "いいね" をたくさんもらっていたので、これに載っているコーディング規約たちがコメントに言及しているか調べてみましたが、// の後のスペースについて明示的に書いているものはありませんでした。

以下の規約たちにはドキュメント用以外のコメントについて書かれていませんでした。

• Zend Framework Coding Standard for PHP (1.x)
• Zend Framework Coding Standard for PHP (2.x)
• Symfony Coding Standards (古い日本語版はこちら)
• Yii Core framework code style (1.x)

以下の規約たちには、通常のコメントについて言及があるものの、// の後のスペースについて明示的には書かれていませんでした。

• PEAR Coding Standards : コメントについての記述はこちら
• CakePHP Coding Conventions (2.x)
• CakePHP Coding Conventions (3.x)
• CodeIgniter PHP Style Guide
• Yii 2 Core Framework Code Style
• Laravel Coding Style および StyleCI の Laravel プリセット
• WordPress PHP Coding Standards および WordPress PHP Documentation Standards

最後に "PHP coding standards" で検索すると上位に出てくる中に含まれる FuelPHP Coding Standards も見てみましたが、こちらもドキュメント以外のコメントについては言及がありませんでした。

個人的には、コードの意味を説明する意図の行コメントには // の後にスペースを入れる方式がよく使われているように思います。しかし、コーディング規約で明確に示しているものは見つかりませんでした。