【PHP入門】コメントアウトの使い方(3つのパターンを解説!)

書いた人 ヤマシタ

コメントアウトは、プログラミングの際に処理の役割や説明をする上で、大変重要な役割を持っています。

PHPではさまざまな方法でコメントアウトをすることができます。

この記事では、

・「//」を使用したコメントの付け方
・「/* */」を使用したコメントの付け方
・「#」を使用したコメントの付け方

という基本的な内容から、

・コメントアウトの応用的な使い方
・HTML含む場合のコメント方法
・コメントアウトの注意点

などのコメントの応用的な使い方について解説します。

コメントはコーディングする上で必ずしも記載が必要なものではありませんが、重要な要素の1つであることに変わりありません。

ここではPHPのコメントについて詳しく解説していきます!

コメントアウトとは?

ここでは、コメントアウトについておさらいしてみましょう。

用語検索サービスである「コトバンク」では、コメントアウトについて以下のように説明しています。

    「プログラムの中に書き込まれた、処理の記述以外の説明文のことをコメントという。」

コトバンク

コメントは、作成者の覚書きに使用することが多い印象ですが、ファイル名やプログラムのバージョン、クラス名、関数名を記述したり、

不具合を修正するときなど、さまざまな用途でよく使用されます。

一見複雑な処理でも、コメントを確認すれば処理内容が分かるように、

各処理については、厳密にコメントを記載することをルールとしている企業もあります。

また、プログラムを修正するときに、元々記述している処理を消してしまうのではなく、

将来元に戻す可能性のあるときに、処理をまるごとコメントして無効化するときにも使われます。

PHPのコメントアウト3つのパターン

ここでは、PHPでコメントするさまざまな方法について紹介します。

行頭に「//」を付ける

「//」は、行頭から行末まで1行でコメントする場合によく使用します。

一般的によく使用するタイプのコメントです。

コメント範囲を「/* */」で囲む

「/* */」は複数行コメントする場合によく使います。

間に改行を入れることも可能です。

「/* */」の形式はコメントをネストすると最後の「*/」が無いと判断されて、エラーとなりますので注意しましょう。

行頭に「#」を付ける

「#」は、「//」と同じく行頭から行末まで1行でコメントするときに使用します。

シェルやCSVファイルのコメントでよく使用される形式です。

HTML含む場合のコメント

PHPのソースをまとめてコメント

HTMLのコメントを使用して、PHPのソースをまとめてコメントすることもできます。

以下の例では’コメントのテスト1’の箇所のPHPのソースがまるごとHTMLのコメントで囲まれています。

実行結果:

PHPのコメントを使用する

以下のような方法でもPHPのソースを丸ごとコメントアウトすることができます。

コメントアウトの注意点

コメントは多用すると、タグが全て閉じられなかったり、コメントアウトがされない場合がありますので注意しましょう。

以下のようなコメントが入れ子になっている場合はうまくコメントされません。

また、phpのタグの前で/**/を使用してコメントしても、コメントされませんので注意しましょう。

コメントの応用的な使い方

プロジェクトによっては、コメントの付け方も厳密に決められていることがあります。

コメントは後から処理を見直したり、他の人がソースを読んだときに、ひと目で処理内容が分かるようにコメントを記述することも大切です。

以下にPHPのAPIドキュメントを生成するPHP Documentorを使用する際に、記述するコメントの例を紹介します。

大体において、クラスやメソッドなどは先頭にこのようなコメントを記述することが多いと言えます。

・クラス名

・関数/メソッド名

・定数

まとめ

ここではPHPのコメントについて、

・「//」を使用したコメントの付け方
・「/* */」を使用したコメントの付け方
・「#」を使用したコメントの付け方
・HTMLを含む場合のコメント方法
・コメントアウトの注意点

などについて解説しました。

コメントは、ただ処理の内容をコメントするだけではなく、さまざまな用途で使用しますので、普段からコメントの付け方については意識しておきましょう。

もし、コメントの用途や詳細を忘れてしまったら、この記事を思い出してくださいね!

現役フリーランスエンジニアによる無料体験レッスン実施中!

もし、あなたが、

  • 経験、年齢、学歴に不安がある
  • 挫折しない学習方法が知りたい
  • アプリ開発で困っている
  • エンジニアの”生”の声が聞きたい!
  • 仕事獲得の仕方がわからない
  • エンジニアに転職したいが何をすればいいかわからない

など、プログラミング学習やキャリアのことでお困りであれば、まずは『無料体験レッスン』にお申し込み下さい。

あなたにとって、最適の解決策をご提案させていただきます。

詳しくは下の画像から詳しいサービス内容をご確認ください。

cta_mtm3

非常識な結果を出す卒業生多数!

エンジニアキャリア戦略

人気記事セレクション

LINEで送る
Pocket

この記事が気に入ったら
いいね!をしてフォローしよう

最新情報をお届けします

書いた人

ヤマシタ

フリーランスエンジニア。ITに関わるさまざまなコンテンツの企画・制作も行っています。
ITに関してはノウハウ系、ライフハック系、トレンド系など、今まで200本以上の執筆経験があります