・ヮ・）あ、おはようございまーす
みなさん Xdebug 使ってますか？
ステップ実行便利ですよね！
つい先日 PHP8 で開発環境を作っていたらエラーがでました
Xdebug: [Config] The setting 'xdebug.xxx' has been renamed, see the upgrading guide at
Xdebugさんバージョン3になったんですね（知らなかった
2 から 3 に バージョンアップするにあたって 設定方法がいくつか 変わったらしく エラーになってました
Upgrading from Xdebug 2 to 3
自分の環境はドキュメント読みつつ新しい設定に直したのですが
同僚やお友達から「設定を手伝っておくれ」と何回か言われて いちいち調べ直すのが面倒になり変換ツールを作りました
Xdebug2の設定を3の設定に変換するやつ
↑ここから飛べます
注意事項
- やっつけで雑に作ってしっかりテストしていません
- メンテナンスをする気はありません
- 自己責任でお使いください
- ドキュメント読みましょう
- CSSはお亡くなりになりました
変換しきれない設定項目
Xdebug2 のときは 個別に設定できた項目が 1つにまとめられているものが いくつかあります
優先したい設定に合わせて選んでください
xdebug.start_with_requests
Xdebug2の設定が
xdebug.auto_trace = true もしくは xdebug.remote_autostart = true
のときは xdebug.start_with_requests = yes
Xdebug2の設定が
xdebug.profiler_enable_trigger= true もしくは xdebug.trace_enable_trigger= true
のときは xdebug.start_with_requests = trigger
xdebug.start_with_requests はXdebug3 で新しく追加された設定項目です
ドキュメントを読んで設定しましょう
output_dirs
xdebug.gc_stats_output_dir 、 xdebug.profiler_output_dir 、 xdebug.trace_output_dir
これらの設定が xdebug.output_dirs 1つになったようです
別々に設定されていた方はどれか一つ選んで設定する必要があります
xdebug.trigger_value
xdebug.profiler_enable_trigger_value 、 xdebug.trace_enable_trigger_value
これらの設定が xdebug.trigger_value 1つになったようです
別々に設定されていた方はどれか一つ選んで設定する必要があります
削除された項目
xdebug.collect_includes
xdebug.collect_vars
xdebug.extended_info
xdebug.overload_var_dump
xdebug.remote_handler
xdebug.show_mem_delta
これらの項目が削除されたようです
詳しくはドキュメントを読んでください
サイレントで消えた項目？
アップグレードガイドには載ってないのですが Xdebug2 には存在していて Xdebug3 には存在しない項目がありました
xdebug.manual_url
xdebug.profiler_aggregate
xdebug.remote_cookie_expire_time
見落としだったらすみません
一応入力されたらそのままの値で出力するようにしました
おまけ
xdebug.mode = debug
xdebug.start_with_requests = yes
の状態で IDEでステップ実行を開始せずに コマンドラインからPHPファイルを実行すると
タイムアウトして接続できなかった というエラーが表示されます
Xdebug: [Step Debug] Time-out connecting to debugging claited: 200 ms. Tried: ホスト (through xdebug.client_host/xdebug.client_-(
Laravel で artisan コマンドを実行するときなど 出てきます
対処方法は
# XDEBUG_MODE環境変数を使って一旦すべての機能をoffにする
export XDEBUG_MODE=off && php artisan xxx
もしくは
; log_levelを0にする
; logが出力されなくなるので注意(log見る人いる？
xdebug.log_level=0
するとエラーが表示されなくなります！