【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を含む場合のコメント方法
  • コメントアウトの注意点

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

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

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

おすすめのコンテンツ

あなたにぴったりなプログラミング学習プランを無料で診断!

「何の言語から勉強すればいいかわからない・・・」そんなあなたに質問に答えていくだけで、何の言語を学べば良いのか診断いたします!未経験から6ヶ月でプログラミング習得に向けた学習プランが1分で分かる!

自分にプログラミングなんて・・・と思っていませんか?

今後10年間で今ある職業の『77%』はなくなると言われています。

人工知能や機械学習を筆頭にVR、AR、ドローンなどの最先端技術の発達はこれからのあなたの働き方に間違いなく影響を与えるでしょう。

将来を見据えてプログラミングができるようになってエンジニアになりたい、自分だけにしかできないクリエイティブな仕事がしたい、、、とお考えの方も少なくないでしょう。

と、同時に「難しそう、、自分にはできないだろう、、、」と諦めている方も多いのではないでしょうか。

弊社マンツーマンレッスンは、お一人お一人に専属のインストラクターがつくので、通常のスクールでは難しい、オリジナルアプリ開発や、フリーランスとしての仕事獲得まで支援しています。

まずは『無料体験レッスン』で弊社コンサルタントと一緒にあなた専用の学習カリキュラムを考えてみてはいかがでしょうか?

詳しくは下の画像をクリックしてください。

cta_mtm2

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

エンジニアキャリア戦略

人気記事セレクション

3000名以上来場の人気セミナーが開催決定

18歳で時給6000円だった侍エンジニア塾代表の木内より、『プログラミングで人生を変える』ための学習方法をお教えます。

0からプログラミングを習得し、フリーランスエンジニアになる方法プログラミング学習の効率を劇的に上げる学習メソッドを解説しますので、奮ってご参加ください。

  • 日付:4/20(土),4/27(土)
  • 時間:14:00〜17:35終了予定
  • 場所:当社 道玄坂オフィス
  • 住所:〒150-0043 東京都渋谷区道玄坂2丁目11-1 Gスクエア渋谷道玄坂 4F *Googleマップでは「東京都渋谷区道玄坂2丁目11-1」で検索してください。近隣にスクエア渋谷という別のビルがあるためご留意ください。
  • 参加費:無料
  • URL:https://seminar.sejuku.net/
詳しくは下の画像をクリックして弊社セミナー内容をご確認ください。

LINEで送る
Pocket

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

最新情報をお届けします

書いた人

ヤマシタ

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