これはなに
PHPStormとdocker上のxdebugを連携したいケースで、
「なんで繋がんないんだよ！！」ってなったので、
ヒントになることを書きます。
Xdebugとは？
Xdebugとは高機能なPHPのデバッグツールです。 PHPのデバッグでおなじみの「var_dump」を見やすくしてくれたり、ボトムネックになっている処理を見つけたり、ステップ実行できたりします。 その他のデバッグツールとしてはZendDebuggerがあります。
Xdebugを使い倒す5つのTIPS | スマホサイト・アプリをつくろう。
より。
ログを有効化する
xdebug.iniやphp.iniに設定を追加しましょう。
追加したらnginxやapacheの再起動が必要です。
xdebug.remote_log=/tmp/xdebug.log
/tmp/xdebug.logにログが表示されますので、
出力されたエラー内容を見て、原因を特定しましょう。
ググれば関連する情報が出てきます。
ログを見ないで疎通させようとするのは、地図を持たないで山に入るようなもんです。
そもそもxdebugの設定が読み込まれているか？
xdebugの設定を記載してもxdebugが動かない、ログも出ないときは
phpに設定が読み込まれているか確認しましょう。
xdebug.soの読み込み忘れでxdebugが動いていなかったり、
別のファイルで設定が上書きされていた、なんてこともありえます。
下記のコマンドは、phpに読み込まれている設定値を出力するものです。
xdebugが有効になっている場合は、xdebug関係の設定がいくつか出力されます。
php -r 'phpinfo();' | grep xdebug
| grep xdebug の部分は絞り込みをしています。
PHPStorm上のPath Mappingが設定されているか？
docker上のファイルパスと、ローカルPC上のファイルパスのマッピングを設定する必要があります。
index.phpにブレークポイントを設定する
ブラウザからアクセスされた時に必ず実行されるところにブレークポイントを貼ってみましょう。
laravelだとpublic/index.phpです。
これで、xdebugが動いていないのか、ブレークポイントの追加する場所が悪いのか原因の切り分けができます。
以上、参考になりましたら幸いです。
参考
https://qiita.com/haruna-nagayoshi/items/99fa041e884c2c3975d2
https://qiita.com/castaneai/items/d5fdf577a348012ed8af
https://qiita.com/taniai-lvgs/items/8e9eba112d2d0ed2530f