1.何が起きたか
EclipseでPHPファイルをデバッグモードで実行しようとしたところ、下記エラーが出て実行できませんでした。
「起動エラー：起動構成'sample(ファイル名)'がデバッグ・モードで開始できませんでした。'Default PHP Web Server'サーバー構成に対応するデバッガーが指定されていません。」
【環境】
- Eclipse
Pleiades All in One＞Eclipse2024＞PHP Windows x64 Full Edition（Version: 2024-12 (4.34)）
Apacheのポート番号は80（下記スクショ参照）
2.解決方法
2-a.結論
Xdebugを使った。
・Xdebug(デバッガー)のHPからdllファイルをダウンロードし、
・dllファイル名を「php_xdebug.dll」に変更し、
・「php_xdebug.dll」を「\xampp\php\ext」に移動し、
・Eclipseで
-デバッガーを「Xdebug」とし
-デバッガーのポート番号を（9000から）「9003」に変更し（3か所）
-リモートセッション受信(JIT)を（localhostから）「プロンプト」に変更し
・Ecliplseを閉じ、ApacheとMySQLをStopし、
・ApacheとMySQLをStartし、Eclipseを立ち上げると・・・
デバッグできるようになった！！
以下に詳細を記録しました。
2-b.解決方法に出会うまで
「Eclipse PHP デバッグできない」等でググるも意外とヒットする記事が少なかった。あっても4年前（2020年）以前の記事で情報が古かった。
なのでXで検索した。
2024年11月3日（2025年2月現在の3か月前！）のこちらのつぶやきを発見。
リンク先の下記ブログ記事（つぶやき元の67th Starさんが書かれたもの）をメインで参照させていただきました。ありがたい…。
「eclipseでXdebugを有効にする、ブレークポイントに止まらない症状も修正」（67th Star)
2-c.解決方法
1. https://xdebug.org/wizard
にアクセス。
2. アクセス先の枠（下スクショ）にphpinfo情報を貼り付け、「Analyse my phpinfo() output」を押下。
※phpinfo情報の確認方法
「Pleiades All in One」を設定済みならapacheを起動して下のURLよりphpinfoを確認できる。
(引用元：「eclipseでXdebugを有効にする、ブレークポイントに止まらない症状も修正」67th Star)
http://localhost/dashboard/phpinfo.php にアクセスすると下記が表示される。
スクショ部分の下部にも
「HTTP Headers Information、bcmath、bz2、calendar、Core、（中略）、PHP Credits、PHP License」
と項目が続いており、どの部分をコピペしたらよいのか迷ったが、「Ctrl+A」で全選択してコピペした。
3. dllファイルをダウンロード
表示されたリンク（下記赤枠）を押下。
（Chromeからダウンロードしたら、Chromeにダウンロードをブロックされた。Chromeで表示された「未確認のファイルをダウンロード」を押下してダウンロードを強制実行した。）
4. dllファイル名を変更
ダウンロードされたファイル名は「php_xdebug-3.4.1-8.2-ts-vs16-x86_64.dll」だった。
これを「php_xdebug.dll」に変更。
5. 「php_xdebug.dll」を「\xampp\php\ext」に移動
ファイル「php_xdebug.dll」を
フォルダ「（省略）\pleiades\（省略）\xampp\php\ext」に移動
6. Eclipseの設定
Eclipseの上部「実行」＞「デバッグ構成」でデバッグ構成タブを開く
→「デバッガー」タブ＞「構成」でサーバーの編集タブを開く
→「デバッガー」のプルダウンから「Xdebug」を選択
→ポート番号がデフォルトは9000になっているので、「9003」に変更→「完了」
※ポート番号を9003に変更する理由・・・
Xdebugの標準のデバッギングポートは 9000 から 9003 へ変更されました。
（引用元：Xdebugウェブサイト「Xdebug 2 から 3 へのアップグレード」）
※この時点でphp.iniの内容を確認すると・・・
最下行に下スクショの文言が自動追加されていた。
※67th Starさんのブログ記事で紹介されていた方法はここまで。67th Starさんはここまでの方法で、デバッグが正常作動するようになったとのこと。
→しかし、私はこの方法だけでは正常作動しなかった。（デバッグ時にブレークポイントで止まらない現象が起きた。(下記「3.結果」の［3. 問題発生］参照)）
→この方法に加えて下記「3.結果」の ［4. Eclipseの設定を修正］と［6. ApacheとMySQLを再起動］を実行したら、正常作動するようになった。
3. 結果
1. パースペクティブ設定
Eclipseの上部「ウィンドウ」＞パースペクティブ＞パースペクティブを開く＞デバッグ
2. デバッグ実行
デバッグ実行したいphpファイルを右クリック＞デバッグ＞3 PHP Webアプリケーション
3. 問題発生
デバックは無事実行できたけど、ブレークポイントで止まらない（変数タブに何も表示されない&停止ボタンは赤色に色づいているけど、ステップオーバーとステップインのボタンは色づいておらず押せない）
4. Eclipseの設定を修正
①Eclipseの上部「ウィンドウ」＞設定＞PHP＞インストール済みのPHP
「PHP8（以下略）」を選択＞編集＞デバッガー＞ポート番号を確認
9000になってる！！→9003に変更＞OK＞適用して閉じる
②Eclipseの上部「ウィンドウ」＞設定＞PHP＞デバッグ＞デバッガーを選択→Xdebugを選択→構成
→デバック・ポートを9000から「9003」に変更。
→リモートセッション受信(JIT)が「localhost」になっているので「プロンプト」に変更。
→OK＞適用して閉じる
5. デバッグ実行に再挑戦！
デバッグ実行したいphpファイルを右クリック＞デバッグ＞3 PHP Webアプリケーション
↓
やっぱりできない。
6. ApacheとMySQLを再起動
仮説：Apacheを再起動して書き換えられたphp.ini等をリロードする必要があるのではないか？？
検証：Ecliplseを閉じ、XMAPP Control PanelでApacheとMySQLをStop。
（MySQLの再起動は不要かとも思ったが、ついでに再起動してみた。再起動した後で、検証なのだからまずはApacheだけを再起動すれば良かったなと反省。次回同じケースがあったらその際はApacheだけ再起動してみよう。）
→XMAPP Control PanelでApacheとMySQLをStart。Eclipseを起動。
7. デバッグ実行に再再挑戦！
デバッグ実行したいphpファイルを右クリック＞デバッグ＞3 PHP Webアプリケーション
↓
PHPデバッグ（下スクショ）が表示される。→「はい」
↓
できたーーーーー！！！！
4.最終結果
・Xdebug(デバッガー)のHPからdllファイルをダウンロードし、
・dllファイル名を「php_xdebug.dll」に変更し、
・「php_xdebug.dll」を「\xampp\php\ext」に移動し、
・Eclipseで
-デバッガーを「Xdebug」とし
-デバッガーのポート番号を（9000から）「9003」に変更し（3か所）
-リモートセッション受信(JIT)を（localhostから）「プロンプト」に変更し
・Ecliplseを閉じ、ApacheとMySQLをStopし、
・ApacheとMySQLをStartし、Eclipseを立ち上げると・・・
デバッグできるようになった！！
疑問＆回答
Q1）dllファイルって何？
Dynamic Link Library。
Windowsで使われる「動的リンクライブラリ」。
プログラムが必要な機能を呼び出せるようにするファイルで、例えばphp_xdebug.dllならXdebugのデバッグ機能を提供する。
PHP本体とは別のファイルになっているから、必要なときだけロード（読み込む）して使えるのが特徴。
Q2）リモートセッション受信(JIT)を（localhostから）「プロンプト」に変更したけど、これは何をしてるの？
「JIT（Just-In-Time）デバッグ」は、スクリプトがエラーを起こしたときにデバッガーを起動する仕組み。
localhost（デフォルト）
→ Xdebugは「localhost（127.0.0.1）」のデバッガー（例えばEclipse）に自動的に接続しようとする。
プロンプト
→ Xdebugがデバッグを開始するときに「どのデバッガーに接続するか？」を聞いてくる。
つまり、デバッグのタイミングで接続先を選べるようになったということ。例えば、複数のデバッガー（Eclipse以外のツール）を使う場合にも便利。
（・・・いまいちよくわからない！！）
Q3）最後にApacheとMySQLとEclipseを再起動する必要性
dllファイルの変更をApache（PHPの実行環境）に反映させるには再起動が必要。
理由：
php_xdebug.dllは、PHPが起動したときに一度だけ読み込まれる（ApacheがPHPをロードするとき）。だから、Apacheを再起動しないと新しいXdebugの設定が適用されない。
EclipseもXdebugとの接続を確立する必要があるから、再起動して正しく設定を読み込ませる。（再起動しないとPHPが古い設定のまま動いてしまう可能性がある。）
再起動の流れ：
① Apacheを停止（PHPが使っていた古いXdebugを解放）
② MySQLもついでに停止（PHPと連携することがあるため）
③ Apacheを再起動（新しいXdebugを読み込む）
④ MySQLも再起動（必要なら）
⑤ Eclipseを再起動（正しくデバッガーの設定を反映）
参考
「eclipseでXdebugを有効にする、ブレークポイントに止まらない症状も修正」67th Star