PHP 速習チュートリアル

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!';