如何配置Xdebug v3.1.1与PHP8.1实现美化的栈追踪输出？

是否需要在php.ini中开启特定的Xdebug配置项？

期望的输出样式 #

带有彩色高亮、层级缩进清晰的栈追踪，每个调用栈的文件路径、行号、函数名等信息排版整齐，可读性强。

当前的输出样式 #

纯文本格式的栈追踪，无高亮效果，排版紧凑，信息展示不够直观。

当前的Xdebug配置（PHP 8.1 php.ini） #

[XDebug]
xdebug.client_host=127.0.0.1
xdebug.client_port=9000
xdebug.mode=debug
xdebug.profiler_append = 0
xdebug.start_with_request=trigger
xdebug.remote_handler = dbgp
xdebug.start_with_request=yes
xdebug.log_level = 0
xdebug.force_display_errors=1
xdebug.force_error_reporting=1
xdebug.show_error_trace=1
xdebug.show_exception_trace=1
xdebug.cli_color = 1
xdebug.trace_format=1 
xdebug.show_local_vars=1

要实现美化的栈追踪输出，需调整Xdebug的几个关键配置项，具体如下：

• 保留CLI彩色高亮：你当前已开启xdebug.cli_color = 1，这个配置会让CLI环境下的错误和栈追踪输出带有彩色高亮，无需修改。
• 修改栈追踪格式：将xdebug.trace_format从1改为2——格式1对应纯文本输出，格式2是HTML美化格式，这是实现你期望样式的核心调整。
• 清理冲突配置：你重复设置了xdebug.start_with_request（trigger和yes），保留xdebug.start_with_request=yes即可，让Xdebug随请求自动启动。
• 保留追踪显示配置：继续启用xdebug.show_error_trace=1和xdebug.show_exception_trace=1，确保错误/异常发生时自动输出栈追踪。
• 局部变量显示（可选）：xdebug.show_local_vars=1会在栈追踪中展示每个调用栈的局部变量，如需精简输出可改为0。

修改后的配置示例 #

[XDebug]
xdebug.client_host=127.0.0.1
xdebug.client_port=9000
xdebug.mode=debug
xdebug.profiler_append = 0
xdebug.start_with_request=yes
xdebug.remote_handler = dbgp
xdebug.log_level = 0
xdebug.force_display_errors=1
xdebug.force_error_reporting=1
xdebug.show_error_trace=1
xdebug.show_exception_trace=1
xdebug.cli_color = 1
xdebug.trace_format=2  ; 切换为HTML美化格式
xdebug.show_local_vars=1

效果说明 #

调整配置后，PHP发生错误或抛出异常时，Xdebug会输出带有彩色高亮（CLI环境）、层级清晰的美化栈追踪，包含每个调用栈的文件路径、行号、函数参数及局部变量等信息，与你期望的样式一致。

内容的提问来源于stack exchange，提问作者VladacusB