PHP のコメント
1. PHPにおけるコメント
PHPのコメント(Comments)は、コード(Code)の一部として実行されることはありません。その唯一の目的は、コードを読んでいる人に内容を伝えることです。
PHPのコメントは、主に以下の用途で使用されます:
- 他者がコードを理解するのを助ける: チーム開発において意図を伝えます。
- 自分のための備忘録: ほとんどのプログラマーは、1〜2年後に自分のコードを見直した際、何をしたのか再確認する必要に迫られます。
- コードの一部を一時的に除外する: テスト(Testing)の際に特定の処理を実行させないようにします。
PHPは、以下の2種類のコメントをサポートしています:
- シングルライン(Single-line)・コメント
- マルチライン(Multi-line)・コメント
1.1 PHPコメントの構文例
// これはシングルライン・コメントです
# これもシングルライン・コメントです
/* これは
マルチライン(複数行)
コメントです
*/2. PHPのシングルライン・コメント
シングルライン・コメントは、// または # で始まります。
// または # の後に続くテキストは、その行の終わりまで無視されます。以下の例では、説明としてシングルライン・コメントを使用しています。
2.1 コードの前にコメントを記述する例
// ウェルカムメッセージを出力
echo 'Welcome Home!';2.2 コード行の末尾にコメントを記述する例
echo 'Welcome Home!'; // ウェルカムメッセージを出力3. コードを無視するためのコメント
コメントを使用して、特定のコード行が実行されないようにすることも可能です。これはデバッグ(Debug)作業などで頻繁に利用されます。
3.1 使用例:ウェルカムメッセージを表示しない
// echo 'Welcome Home!';