如果这个设置为 1，当在 CLI 模式并且输出是一个终端（tty）时，Xdebug 将会给 var_dumps 和堆栈跟踪输出附上颜色。在 Windows 系统下，需要安装 ANSICON 工具。

如果设置为 2，无论是否连上了终端和 ANSICON 是否安装，Xdebug 都将会给 var_dumps 和堆栈跟踪输出附上颜色。在这种情况下将不会看到转义的代码。

看这篇文章了解更多信息。

这个设置默认为 0，控制 Xdebug 是否应该添加变量语句到函数跟踪中。

从 Xdebug 2.6开始，变量赋值 (=&) 语句也包括在其中。

这个设置默认为 0，当一个函数被函数跟踪或堆栈跟踪记录时，控制 Xdebug 是否收集参数传递给函数。

设置默认为 0 是因为非常大型的脚本会消耗巨大的内存，因此这样能让大型脚本运行起来。除了在大量函数调用和（或者）大型数据结构作为参数的脚本，都能最大程度的的安全的开启这个设置。 Xdebug 2 增加内存消耗时不会有这个问题，因为它从不将信息储存在内存中。相反它只会写入磁盘中。这意味着你需要查看磁盘空间使用情况。

这个设置有 4 个不同的值。针对每个值会有不同的信息显示。下面你将会看到每个值提供的信息是什么。也可以看堆栈跟踪特征的介绍提供的一些屏幕截图。

¹ 在 PHP 的 CLI 版本中将不会有 the tool tip，在输出文件中也没有。

设置默认为 0，控制 Xdebug 是否应该将函数调用的返回值写入跟踪文件。

对于计算机的跟踪文件 （xdebug.trace_format=1） 仅仅只从 Xdebug 2.3 开始工作。

* 可以是 COOKIE，FILES，GET，POST，REQUEST，SERVER，SESSION 中的任何值。这 7 个设置控制了当错误状况出现时超级全局变量中的哪个数据将会显示。

每一个 php.ini 中的设置可以由逗号分隔的变量目录组成来实现转储，其中变量来自这个超级全局变量数组，或者是 * 他们所有。需要确保没有在这个设置中添加空格。

当错误出现为了转储 REMOTE_ADDR，REQUEST_METHOD 和所有 GET 参数，添加这些设置：

xdebug.dump.SERVER = REMOTE_ADDR,REQUEST_METHOD
xdebug.dump.GET = *

这个设置决定了在堆栈跟踪中显示文件名的链接形式。这允许 IDE 设置链接协议，通过点击 Xdebug 在堆栈跟踪中显示的文件名就能直接进入文件以及指定的行。格式会像这个示例：

myide://%f@%l

可能的格式说明符：

针对不同的 IDE 或者 OS，这里是一些让其工作的说明清单：

Firefox on Linux

• 打开 about:config
• 添加一个新的布尔值设置 "network.protocol-handler.expose.xdebug"，设置为 "false"
• 添加下面的代码到一个 shell 脚本 ~/bin/ff-xdebug.sh:

  #! /bin/sh
  
  f=`echo $1 | cut -d @ -f 1 | sed 's/xdebug:\/\///'`
  l=`echo $1 | cut -d @ -f 2`
  

  添加其中的一个（决定于是使用的 komodo，gvim 还是 netbeans）:
  • komodo $f -l $l
  • gvim --remote-tab +$l $f
  • netbeans "$f:$l"
• 让脚本执行 chmod +x ~/bin/ff-xdebug.sh
• 设置 xdebug.file_link_format 为 xdebug://%f@%l

Windows and netbeans

• 创建一个文件 netbeans.bat ，保存到你的路径（C:\windows 将会有效）：

  @echo off
  setlocal enableextensions enabledelayedexpansion
  set NETBEANS=%1
  set FILE=%~2
  %NETBEANS% --nosplash --console suppress --open "%FILE:~19%"
  nircmd win activate process netbeans.exe
  

  注意：如果你不需要 nircmd 请移除最后一行。

• 保存下面代码到 netbeans_protocol.reg:

  Windows Registry Editor Version 5.00
  
  [HKEY_CLASSES_ROOT\netbeans]
  "URL Protocol"=""
  @="URL:Netbeans Protocol"
  
  [HKEY_CLASSES_ROOT\netbeans\DefaultIcon]
  @="\"C:\\Program Files\\NetBeans 7.1.1\\bin\\netbeans.exe,1\""
  
  [HKEY_CLASSES_ROOT\netbeans\shell]
  
  [HKEY_CLASSES_ROOT\netbeans\shell\open]
  
  [HKEY_CLASSES_ROOT\netbeans\shell\open\command]
  @="\"C:\\Windows\\netbeans.bat\" \"C:\\Program Files\\NetBeans 7.1.1\\bin\\netbeans.exe\" \"%1\""
  

  注意：确保更换路径到 Netbeans（两次），如果你保存的地方不是 C:\windows 那么 netbeans.bat 批处理文件也是如此。

• 双击 netbeans_protocol.reg 文件导入它到注册表。
• 设置 xdebug.file_link_format 为 xdebug.file_link_format = "netbeans://open/?f=%f:%l"

这个设置决定了在 HTML 堆栈跟踪中 Xdebug 呈现的文件名（默认： ...%s%n）和通过 xdebug_var_dump() 重载的位置信息（默认：%f）的格式。

此表列出了可能的格式说明符。示例输出是根据全路径 /var/www/vendor/mail/transport/mta.php 呈现。

如果这个设置设置为 1，无论 PHP 的 display_errors 为多少，错误都将会显示。

这个设置是一个位掩码，像 error_reporting。这个位掩码将会与 error_reporting 所表示的位掩码进行逻辑与运算来决定应该显示哪种错误。这个设置只能在 php.ini 中完成，无论一个应用中 ini_set() 的值是多少，它允许你强制显示某些错误。

这个设置允许你配置一个位掩码来决定是否将通知和（或者）警告转换为错误，以及将哪些通知和（或者）警告转换为错误。你可以配置 PHP 生成的通知和警告和你自己生成的通知和警告（意思是 trigger_error()）。例如，转换 strlen()（没有参数）的警告为错误，你可以：

ini_set('xdebug.halt_level', E_WARNING);
strlen();
echo "Hi!\n";

这结果将会是显示错误信息并且终止脚本。echo "Hi!\n"; 将不会执行。

这个设置是位掩码，针对所有应用转换所有通知和警告为错误，可以在 php.ini 中设置这个：

xdebug.halt_level=E_WARNING|E_NOTICE|E_USER_WARNING|E_USER_NOTICE

这个位掩码只支持上面提到的 4 种错误级别。

针对无穷递归的控制保护机制。在脚本中止之前，这个函数嵌套的最大层级的设置值是被允许的。

Xdebug 2.6之前，如果超出这会创建一个致命的异常。从 Xdebug 2.6 开始及更高版本 ，而是抛出一个 "Error" 异常。

在 Xdebug 2.3 之前，默认值是 100。

控制堆栈跟踪中显示的堆栈帧数量，基于 PHP 错误堆栈跟踪期间的命令行，以及浏览器中的 HTML 跟踪。

当 html_errors 在 php.ini 中设置为 1 或者 2 时，Xdebug 默认用自己改进的版本重载 var_dump() 来显示变量。如果你不希望这样，可以设置这个值为 0 ，但是首先要检查是否没有智能的关掉 html_errors。

你可以设置这个值为 2 。这将会在输出中添加文件名和行号，并且能很好地格式化 var_dump() 输出。这个 xdebug.file_link_format 设置也是推荐的。（在 Xdebug 2.3 中新增）

在 Xdebug 2.4 之前，这个设置的默认值是 1 。

这个设置决定了用来转储跟踪信息的文件名。这个设置指定了格式化说明符的格式，非常类似于 sprintf() 和 strftime()。这里有几个格式化说明符可以用来格式化文件名。

查看 xdebug.trace_output_name 文档支持的说明符。

如果开启，xdebug.remote_host 设置将会被忽略，并且 Xdebug 将会让 HTTP 请求设法连接到客户端。它会检查 $_SERVER['REMOTE_ADDR'] 变量来寻找哪个 IP 地址可以使用。

如果配置了 xdebug.remote_addr_header ，那么将在 $_SERVER['HTTP_X_FORWARDED_FOR'] 和 $_SERVER['REMOTE_ADDR'] 变量之前检查 具有配置名称的 $SERVER 变量。

这个设置不适用于通过 CLI 调试，因为 $SERVER 头部变量在这里不可用。

请注意这里没有过滤变量，即使它的地址不能匹配 xdebug.remote_host，任何人也都能连接到网络服务器然后开启一个调试会话。

也可以为 "php3"，这将选择旧版本的 PHP 的 3 种调试器输出。"gdb" 会开启像调试器接口的 GDB，或者是 "dbgp" —调试器协议。DBGp 协议是唯一支持的协议。

注意： Xdebug 2.1 和以后的版本仅支持 "dbgp" 作为协议。

对 Unix 域套接字支持由 Xdebug 2.6 引入。

Log opened at 2007-05-27 14:28:15
-> <init xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/dbgp/x ... ight></init>

<- step_into -i 1
-> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/db ... ></response>

当一个调试连接初始化时选择。这个设置有两种不同的值：

req

只要脚本开启，Xdebug 就将会尝试连接调试客户端。

jit

只有错误状况出现时，Xdebug 才将会尝试连接调试客户端。

Xdebug 在 IDE 上等待确认传入调试连接以毫秒表示的时间量。默认值 200 毫秒在绝大多数情况下应该是足够的。如果你经常遇到调试请求丢失，可能是因为你有一个高延迟的网络，或者远离 IDE 的开发盒，或者防火墙速度慢，那么你可以增加此值。

请注意，增加此值可能意味着以防 Xdebug 尝试建立连接请求看似“挂起”，但是 IDE 没有在监听。

‘异常’错误在 PHP 7 中引入。

跟踪文件的格式：

计算机格式的字段：

查看函数跟踪的介绍的一些示例。

这个设置决定了用来转储跟踪信息的文件名。这个设置指定了格式化说明符的格式，非常类似于 sprintf() 和 strftime()。这里有几个格式化说明符可以用来格式化文件名。".xt" 扩展总是会自动添加上。

可能的格式化说明符有：

² 从 Xdebug 2.6起，针对跟踪文件名这个是不可用的。

³ 版本 2.2 中的新增。这个可以通过 Apache 的 mod_unique_id 模式 修改。

当变量通过 xdebug_var_dump() 、 xdebug.show_local_vars 或者函数跟踪显示时，控制数组子元素和对象属性显示的数量。

设置值为 -1 ，可以取消显示的任何限制。

这个设置不会对通过远程调试功能发送到客户端的子元素数量有任何影响。

当变量通过 xdebug_var_dump() 、 xdebug.show_local_vars 或者函数跟踪显示时，控制显示的字符串的最大长度。

设置值为 -1 ，可以取消显示的任何限制。

这个设置不会对通过远程调试功能发送到客户端的子元素数量有任何影响。

当变量通过 xdebug_var_dump() 、 xdebug.show_local_vars 或者函数跟踪显示时，控制数组子元素和对象属性嵌套多少层。

你可以选择的最大值是 1023 。你也可以使用 -1 作为值来选择这个最大的值。

这个设置不会对通过远程调试功能发送到客户端的子元素数量有任何影响。