4

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

// コメント

or

//コメント

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

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

6
  • 2
    Manual:Coding conventions/PHP を見ますと、In comments there should be one space between the # or // character and the comment. と書かれていますね。
    – user39889
    Commented 2018年6月16日 6:07
  • おお。metropolisさん ありがとうございます。
    – r-naga
    Commented 2018年6月16日 6:22
  • タグに [php] とありますが、PHP に限定したご質問でしょうか?
    – nekketsuuu
    Commented 2018年6月16日 12:40
  • nekketsuuuさん PHPがわかれば今は充分なのですが、 できれば主要なコーディング規約が知りたいです。 タグは規約等のが見つけられなかったので仮でつけさせていただきました。
    – r-naga
    Commented 2018年6月17日 6:00
  • @r-naga さん、コメントを受けて内容を書き直してみました。異なる部分があれば上書きして頂ければと思います。よろしくお願いいたします。
    – nekketsuuu
    Commented 2018年6月17日 9:29

2 件の回答 2

1

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

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

1

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

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

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

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

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

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

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

この質問に回答するには、ログインする必要があります。

求めていた回答ではありませんか? のタグが付いた他の質問を参照する。