こんにちは！日々のデバッグ作業、お疲れ様です。
コードを書いては「`var_dump()`してリロード」、エラーが出たら修正して「またデプロイ」……そんな無限ループに疲れていませんか？
「コードを1行書き換えて、ブラウザをリロードして、ログインし直して、該当画面まで遷移して……確認に30秒かかる」
これを1日何十回も繰り返していたら、集中力はすり減り、貴重な開発時間が溶けていってしまいますよね。
今回は、世界中のプロフェッショナルなPHPエンジニアが愛用するXdebugの「Eval（Evaluate Expression / 式の評価）機能」について、初心者の方にも分かりやすく、かつ現場で即戦力となるテクニックをお伝えします。
これをマスターすれば、コードを一切書き換えることなく、実行中のプログラムの変数をその場で自由自在に書き換え、ブレークポイント（一時停止）の先でどう振る舞うかをリアルタイムにテストできるようになります。
「あ、ここにデバッグ用のコードを埋め込まなくても、その場で変数の値をいじって挙動を確かめればいいんだ！」と気づいた瞬間、あなたの毎日のコーディングは劇的に楽になりますよ。さあ、一緒に扉を開けてみましょう！
—
1. Xdebugの「Eval機能」とは何か？（なぜ使わないと損なのか）
そもそもXdebugといえば、「ステップ実行（一行ずつコードを進める機能）」で有名ですよね。もちろんそれだけでも強力なのですが、多くの初学者は「止めて、中身を見る」だけで満足してしまいます。
しかし、真のデバッグ職人たちは「止めて、その場でコードを動かす（Eval）」ことをします。
内部で何が起きているのか？
IDE（PhpStormやVS Codeなど）でブレークポイントにヒットしてプログラムが一時停止した瞬間、あなたの開発環境とPHPの実行エンジン（Zend Engine）の間で通信路（DBGpプロトコル）が確立されています。
この通信路を通じて、IDEから「この変数の値を `true` に書き換えて」「この計算式の結果を今すぐ教えて」という命令（Eval）をPHPに送り込むことができます。PHP側は、あたかもそのコードが元からそう書かれていたかのようにメモリ上の変数を書き換え、その後の処理を続行するのです。
- 従来の修正フロー:
コード修正 ➔ 保存 ➔ コンテナ再起動（またはファイルアップロード） ➔ ブラウザ再描画 ➔ 再び同じ状態まで手動で操作 ➔ （失敗したら最初に戻る）※数分かかる
- Evalを活用した高速仮説検証フロー:
ブレークポイントで停止 ➔ コンソールで変数を書き換える ➔ その場で「うまく動くか」を即座にテスト ➔ 成功した修正方針だけをコードに反映する ※数秒で完結
この「数秒の爆速フィードバックループ」を手に入れることが、シニアエンジニアへの第一歩です。
—
2. 最小限のステップで完了する！Xdebugの基礎セットアップ
「難しそうな設定がたくさんありそう…」と身構える必要はありません。現代の開発環境（Docker環境やローカル環境）であれば、本質的な設定はごくわずかです。
ここでは、PHP 8.2以降を想定したモダンな `php.ini` の設定例を見ていきましょう。
php.ini（またはxdebug.ini）の設定例
[xdebug]
; Xdebugのモードを「debug（ステップ実行）」と「develop（エラー表示の見栄え向上）」に指定する
zend_extension=xdebug.so
xdebug.mode=debug,develop
; IDEが待ち受けているポート（デフォルトは9003）に向かってデバッグ情報を飛ばす
xdebug.client_port=9003
xdebug.client_host=host.docker.internal
; スクリプトが実行されたら自動的にデバッグを開始する（必要に応じてON/OFFする）
xdebug.start_with_request=yes
> 先輩からのアドバイス:
> Dockerを使っている場合、`xdebug.client_host=host.docker.internal`（Linuxの場合はホストのIPアドレスや `172.17.0.1` など）を指定するのが鉄則です。これが正しく設定されていないと、IDEがPHPからの「助けて！」というシグナルを受け取れなくなります。
—
3. 実践！「Eval機能」で変数を書き換えてバグの仮説を検証する
それでは、実際にコードが動いている最中に変数をねじ曲げ、挙動が変わる瞬間を体験してみましょう。
いま、次のような簡単なユーザー権限チェックのPHPコードがあるとします。
42,
‘name’ => ‘Yamada’,
‘is_admin’ => false, // ← ここが false なので管理画面に入れないバグの調査中とする
];
// 処理を停止させたい行にブレークポイントを張る
if ($user[‘is_admin’]) {
echo “管理画面へようこそ、{$user[‘name’]}さん！”;
} else {
echo “アクセス権限がありません。（エラー画面）”;
}
このコードを実行すると、`is_admin` が `false` のため、当然「アクセス権限がありません。」が表示されます。
ここで、「もし仮に、このユーザーが管理者権限持ち（`true`）だったら、この後のHTMLやリダイレクト処理は正しく動くのだろうか？」と検証したくなったとします。
ステップ実行とコンソール（Eval）の操作手順
1. ブレークポイントを設定:
`if ($user[‘is_admin’])` の行にIDEでブレークポイント（赤丸）をセットします。
2. デバッグ開始:
ブラウザやCLIからスクリプトを実行すると、プログラムがその行でピタッと停止します。
3. 「Evaluate Expression（式の評価）」コンソールを開く:
- PhpStormの場合: `Alt + F8` (macOSなら `Option + F8`) を押すか、デバッグツールの「眼鏡マーク（Evaluate Expression）」をクリック。
- VS Codeの場合: デバッグパネルの「デバッグコンソール (Debug Console)」を開く。
4. コンソールで変数を書き換える:
コンソール画面に、次のように直接PHPのコードを入力して実行します。
// コンソール（Evaluate Expression）に入力するコード
$user[‘is_admin’] = true;
これだけで、メモリ上の `$user[‘is_admin’]` の値が、その場で `true` に書き換わります！
さらに、コンソール内でそのまま次のように入力して試すことも可能です。
// 現在の変数がどう評価されるかその場でテスト
var_dump($user[‘is_admin’]);
// 出力結果: bool(true)
5. 処理を再開する:
IDEの「Resume（再生ボタン / F9キーなど）」を押して、プログラムの実行を先に進めます。
すると、ブラウザには「アクセス権限がありません」ではなく、「管理画面へようこそ、Yamadaさん！」が表示されます。
コードを一切書き換えることなく、「もし権限があった場合の挙動」の検証が、わずか3秒で完了しました。
—
4. 現場で役立つ！さらに高度なEvalの裏技
変数の書き換えだけでなく、Eval機能は「その場で任意の関数やメソッドを実行する」ことも可能です。
1. デバッグ中にその場で関数を呼び出してデータを整形する
停止中のコンソールで、以下のように叩くことができます。
// 複雑な配列の中身をその場でJSON形式にして綺麗に見る
echo json_encode($user, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
これにより、わざわざ `var_dump` を書かなくても、見やすいフォーマットで巨大なオブジェクトや配列の中身を一瞬で確認できます。
2. 例外（エラー）をその場で投げて異常系のテストをする
「もしここでデータベース接続エラーが発生したら、catchブロックは正しく動くか？」というテストも、Evalなら一瞬です。
// 強制的に例外を発生させて、例外処理（try-catch）のルートへ強制ジャンプさせる
throw new \RuntimeException(‘強制テストエラー’);
これをコンソールから実行してステップを進めれば、エラーハンドリングのコードが正しく動くかをノーリスクで検証できます。わざわざ本番に近いDB障害を再現する必要はありません。
—
まとめ：今日からあなたのデバッグが変わる
いかがでしたでしょうか？
XdebugのEval機能は、単なる「変数ビューア」の枠を超えた、「実行中のプログラムと対話するための強力なコンソール」です。
- コードを書き換えて再デプロイする必要はもうありません。
- 「こうなっているはず」という仮説を、その場で数秒で検証できます。
これをマスターすれば、毎日のコーディングで「試行錯誤にかかる無駄な待ち時間」が綺麗さっぱり消え去り、開発のスピードとコードの品質が跳ね上がります。
ぜひ、今日の開発から「ブレークポイントで止めて、コンソールで変数をいじってみる」というアプローチを試してみてください。あなたの開発ライフが、劇的に快適になることをお約束します！