ch03 8章中 3章目

ch03 — コメント

スライドで見る

この章を AI と学ぶ

💬 AI に聞く質問例 3 件
  1. 「ch03 — コメント」のつまずきやすいポイントを、初学者向けに3つ教えてください

    ChatGPT Claude Gemini

  2. 「ch03 — コメント」について、自分の手で試せる練習問題を3つ出してください (難易度を上げながら)

    ChatGPT Claude Gemini

  3. 「ch03 — コメント」を学んだ後、次に学ぶと良いトピックは何ですか?理由も教えてください

    ChatGPT Claude Gemini

概要

コメントはソースコードに書く PHP が実行しない注釈 で、コードを読み返したときの理解を助ける。動作には影響しないが、現場では 「なぜこの処理を書いたか」を残すための主役 になるくらい重要だ。

PHP には 1 行コメントが 2 種類 あり、// (スラッシュ 2 つ) と # (シャープ) はどちらも行末までをコメント扱いにする。複数行は /* */ で囲むが、閉じ忘れに注意が必要だ。同じ「コメント」でも 3 つの書式が共存しているのは、PHP が長い歴史の中で複数の文化を取り込んで育った経緯がそのまま残っているため。なお /** */ で始まる PHPDoc という別書式もあるが、IDE 補助やドキュメント生成のための仕様でこの章では扱わない。

初学者がコメントを覚える最大の実用メリットは デバッグ時の「コメントアウト」 だ。動かなくなったコードのうち、怪しい行だけを一時的に // で無効化して切り分けると、原因の箇所がぐっと絞り込める。本章のドリル 03 はこの体験そのもので、後の章で必ず役に立つ手筋を最初に仕込んでおく。

学習目標

  • // で 1 行コメントを書ける
  • # も 1 行コメントとして使えると知っている
  • /* */ で複数行コメントを書ける
  • 既存コードをコメントアウトして無効化できる

ドリル

no 内容
01 // で 1 行コメントを書く
02 /* */ で複数行コメントを書く
03 既存コードの一部をコメントアウトして期待出力に合わせる

解説スライド 全 6 枚

右の ボタン キー(またはスワイプ)で次のスライドに進めます。 下の「縦表示」を開くと全スライドを一気に読めます。

  1. コメント

    Lesson 1 / Chapter 3

  2. コメントとは

    <?php
    // この行は実行されない
    echo "実行される\n";
    • PHP が無視する文字列
    • 自分や他人へのメモを書く場所
    • 一時的にコードを無効化するのにも使う
  3. 1 行コメント: //#

    <?php
    // スラッシュ 2 つ
    echo "A\n";
    
    # シャープ 1 つ
    echo "B\n";
    • どちらも その行の最後まで がコメント
    • // のほうが一般的
    • # はシェルスクリプトでよく見るのと同じ書き方
  4. 複数行コメント: /* */

    <?php
    /*
    ここは
    何行でも
    コメントになる
    */
    echo "本文\n";
    • /* で開始、*/ で終了
    • 間に書いた文は 全部無視される
    • 複数行のメモや、長いコードの一時無効化に使う
  5. コメントアウト

    <?php
    echo "1\n";
    // echo "2\n";
    echo "3\n";

    実行結果:

    1
    3
    • 行頭に // を付けるとその行だけ無効になる
    • バグを切り分けるとき、よく使うテクニック
  6. このチャプターでできるようになること

    // # で 1 行コメントを書ける ✅ /* */ で複数行コメントを書ける ✅ 既存コードを一時的に無効化できる

    → ドリルへ

1 / 6
📜 スライドを全部一気に読む(縦表示)

Lesson 1 / Chapter 3


コメントとは

<?php
// この行は実行されない
echo "実行される\n";
  • PHP が無視する文字列
  • 自分や他人へのメモを書く場所
  • 一時的にコードを無効化するのにも使う

1 行コメント: //#

<?php
// スラッシュ 2 つ
echo "A\n";

# シャープ 1 つ
echo "B\n";
  • どちらも その行の最後まで がコメント
  • // のほうが一般的
  • # はシェルスクリプトでよく見るのと同じ書き方

複数行コメント: /* */

<?php
/*
ここは
何行でも
コメントになる
*/
echo "本文\n";
  • /* で開始、*/ で終了
  • 間に書いた文は 全部無視される
  • 複数行のメモや、長いコードの一時無効化に使う

コメントアウト

<?php
echo "1\n";
// echo "2\n";
echo "3\n";

実行結果:

1
3
  • 行頭に // を付けるとその行だけ無効になる
  • バグを切り分けるとき、よく使うテクニック

このチャプターでできるようになること

// # で 1 行コメントを書ける ✅ /* */ で複数行コメントを書ける ✅ 既存コードを一時的に無効化できる

→ ドリルへ

この章で取り組む 演習問題の流れ (3ステップ)
  1. 01 ドリル 01 — 1 行コメント README.md starter.php answer.php
  2. 02 ドリル 02 — 複数行コメント README.md starter.php answer.php
  3. 03 ドリル 03 — コメントアウトで出力を減らす README.md starter.php answer.php

演習問題の詳細

この章の演習問題の内容を読めます。実際に手元で解くには教材リポジトリを clone してください。

ドリル 01 — 1 行コメント

問題

次の出力を出す PHP を書いてください。 コードの中に // を使った 1 行コメントを 1 つ以上入れること。 コメント自体は出力されません。

期待される出力:

晴れ
くもり

ヒント

  • // メモ の形でコメントを書く
  • コメントは出力されないので、echo の出力結果は変わらない
  • 例: // 天気を 2 つ出す

🧪 ブラウザで試す

スライドのコードを写経して ▶ 実行、自分で書いて 📝 採点 で答え合わせ。初回のみ PHP ランタイム読込で数秒かかります。

PHP ランタイム未読込

          

        

ドリル 02 — 複数行コメント

問題

次の出力を出す PHP を書いてください。 コードの中に /* */ を使った複数行コメント(2 行以上にまたがるもの)を 1 つ入れること。 コメント自体は出力されません。

期待される出力:

開始
終了

ヒント

  • /* から */ までが 1 つのコメントブロック
  • 例:
    /*
    このプログラムは
    開始と終了を出す
    */
  • コメントは出力に影響しない

🧪 ブラウザで試す

スライドのコードを写経して ▶ 実行、自分で書いて 📝 採点 で答え合わせ。初回のみ PHP ランタイム読込で数秒かかります。

PHP ランタイム未読込

          

        

ドリル 03 — コメントアウトで出力を減らす

問題

starter.php には 4 つの echo が書かれているが、期待される出力は 2 行だけ。

不要な 2 行を コメントアウト して、期待出力に合わせてください。 echo 文自体は削除せず、// を付けて無効化すること。

期待される出力:

赤
青

ヒント

  • 行頭に // を付けるとその行は実行されない
  • 「赤」と「青」だけ残し、それ以外の echo は // で始める
  • echo 文を // で始めると、その echo は実行されない

🧪 ブラウザで試す

スライドのコードを写経して ▶ 実行、自分で書いて 📝 採点 で答え合わせ。初回のみ PHP ランタイム読込で数秒かかります。

PHP ランタイム未読込

          

        

演習問題(3問)

  1. ドリル 01 — 1 行コメント

    README.md starter.php answer.php

  2. ドリル 02 — 複数行コメント

    README.md starter.php answer.php

  3. ドリル 03 — コメントアウトで出力を減らす

    README.md starter.php answer.php

サイト内で問題文・雛形・解答例を確認できます。実際に手元で解くには教材リポジトリを clone してください。

完了にすると進捗に反映されます