コメントアウトは、プログラミングの際に処理の役割や説明をする上で、大変重要な役割を持っています。
PHPではさまざまな方法でコメントアウトをすることができます。
この記事では、
・「//」を使用したコメントの付け方
・「/* */」を使用したコメントの付け方
・「#」を使用したコメントの付け方
という基本的な内容から、
・コメントアウトの応用的な使い方
・HTML含む場合のコメント方法
・コメントアウトの注意点
などのコメントの応用的な使い方について解説します。
コメントはコーディングする上で必ずしも記載が必要なものではありませんが、重要な要素の1つであることに変わりありません。
ここではPHPのコメントについて詳しく解説していきます!
この記事の目次
コメントアウトとは?
ここでは、コメントアウトについておさらいしてみましょう。
用語検索サービスである「コトバンク」では、コメントアウトについて以下のように説明しています。
-
「プログラムの中に書き込まれた、処理の記述以外の説明文のことをコメントという。」
コメントは、作成者の覚書きに使用することが多い印象ですが、ファイル名やプログラムのバージョン、クラス名、関数名を記述したり、
不具合を修正するときなど、さまざまな用途でよく使用されます。
一見複雑な処理でも、コメントを確認すれば処理内容が分かるように、
各処理については、厳密にコメントを記載することをルールとしている企業もあります。
また、プログラムを修正するときに、元々記述している処理を消してしまうのではなく、
将来元に戻す可能性のあるときに、処理をまるごとコメントして無効化するときにも使われます。
PHPのコメントアウト3つのパターン
ここでは、PHPでコメントするさまざまな方法について紹介します。
行頭に「//」を付ける
「//」は、行頭から行末まで1行でコメントする場合によく使用します。
一般的によく使用するタイプのコメントです。
1 2 3 4 5 6 7 8 |
<?php $str = 'コメントのテストです'; //ここからコメント //結果を出力します。 echo $str; ?> |
コメント範囲を「/* */」で囲む
「/* */」は複数行コメントする場合によく使います。
間に改行を入れることも可能です。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
<?php /* 2017/07/01追記 ここでは、連想配列に値を設定し、 print_rで配列の中身を出力します。 */ $fruits = [0=>'apple', 1=>'orange', 2=>'melon', 3=>'banana', 4=>'pineapple']; /* 結果を出力 */ print_r($fruits); /* このように、 改行を挟むこともできます。 */ ?> |
「/* */」の形式はコメントをネストすると最後の「*/」が無いと判断されて、エラーとなりますので注意しましょう。
1 2 3 4 5 6 7 8 9 10 |
<?php /* /*結果を出力 */ echo 'これはエラーになります'; */ ?> |
行頭に「#」を付ける
「#」は、「//」と同じく行頭から行末まで1行でコメントするときに使用します。
シェルやCSVファイルのコメントでよく使用される形式です。
1 2 3 4 5 6 7 8 |
<?php $str = 'コメントのテストです'; #ここからコメント #結果を出力します。 echo $str; ?> |
HTML含む場合のコメント
PHPのソースをまとめてコメント
HTMLのコメントを使用して、PHPのソースをまとめてコメントすることもできます。
以下の例では’コメントのテスト1’の箇所のPHPのソースがまるごとHTMLのコメントで囲まれています。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
<html> <head> <title>PHP入門</title> </head> <body> <!-- <?php echo 'コメントのテスト1'; ?> --> <?php echo 'コメントのテスト2'; ?> </body> </html> |
実行結果:
1 |
コメントのテスト2 |
PHPのコメントを使用する
以下のような方法でもPHPのソースを丸ごとコメントアウトすることができます。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
<html> <head> <title>PHP入門</title> </head> <body> <?php /* $text = 'コメント'; echo $text; <?php echo 'ここもコメントされる'; ?> */ ?> </body> </html> |
コメントアウトの注意点
コメントは多用すると、タグが全て閉じられなかったり、コメントアウトがされない場合がありますので注意しましょう。
以下のようなコメントが入れ子になっている場合はうまくコメントされません。
1 2 3 4 |
/* echo 'コメントアウト'; echo 'コメントアウト';*/ echo 'コメントアウトされていない';*/ |
また、phpのタグの前で/**/を使用してコメントしても、コメントされませんので注意しましょう。
1 2 3 4 5 6 7 |
/* <?php echo 'コメントアウトされていない';*/ ?> */ |
コメントの応用的な使い方
プロジェクトによっては、コメントの付け方も厳密に決められていることがあります。
コメントは後から処理を見直したり、他の人がソースを読んだときに、ひと目で処理内容が分かるようにコメントを記述することも大切です。
以下にPHPのAPIドキュメントを生成するPHP Documentorを使用する際に、記述するコメントの例を紹介します。
大体において、クラスやメソッドなどは先頭にこのようなコメントを記述することが多いと言えます。
・クラス名
1 2 3 4 5 6 7 8 |
/** * * @package パッケージ名 * @author 作成者 * @since PHP7.1 * @version プログラムのバージョン * */ |
・関数/メソッド名
1 2 3 4 5 6 7 8 9 10 11 12 13 |
/** * *関数/メソッド名 * *処理内容 * *作成日 * * @param string $str 第一引数 * @param integer $num 第二引数 * @return array 戻り値の * */ |
・定数
1 2 3 4 |
/** * 説明 * @see 関連する関数1,関連する関数2 */ |
まとめ
ここではPHPのコメントについて、
・「//」を使用したコメントの付け方
・「/* */」を使用したコメントの付け方
・「#」を使用したコメントの付け方
・HTMLを含む場合のコメント方法
・コメントアウトの注意点
などについて解説しました。
コメントは、ただ処理の内容をコメントするだけではなく、さまざまな用途で使用しますので、普段からコメントの付け方については意識しておきましょう。
もし、コメントの用途や詳細を忘れてしまったら、この記事を思い出してくださいね!
現役フリーランスエンジニアによる無料体験レッスン実施中!
もし、あなたが、
- 経験、年齢、学歴に不安がある
- 挫折しない学習方法が知りたい
- アプリ開発で困っている
- エンジニアの”生”の声が聞きたい!
- 仕事獲得の仕方がわからない
- エンジニアに転職したいが何をすればいいかわからない
など、プログラミング学習やキャリアのことでお困りであれば、まずは『無料体験レッスン』にお申し込み下さい。
あなたにとって、最適の解決策をご提案させていただきます。
詳しくは下の画像から詳しいサービス内容をご確認ください。