php xdebug的配置、调试、跟踪、调优、分析

楼师發表於 2019-9-20 11:39:00

php xdebug的配置、调试、跟踪、调优、分析

<div id="menu-docs">
<div id="support">
<div class="text">
xdebug 的 profiler 是一个强大的工具，它能分析 PHP 代码，探测瓶颈，或者通常意义上来说查看哪部分代码运行缓慢以及可以使用速度提升。Xdebug 2 分析器输出一种兼容 cachegrind 文件格式的分析信息。这允许你能使用出色的 KCacheGrind 工具（Linux，KDE）来分析你的 profiling 数据。在 Linux 可以使用你最喜欢的包管理器安装 KCacheGrind。
在 windows 系统上，有预编译的 QCacheGrind 二进制程序（QCacheGrind 是没有 KDE 绑定的 KCacheGrind）。
在 Mac OSX 系统上，这里也有怎样安装 QCacheGrind 的说明。
Windows 用户可以选择性的使用 WinCacheGrind。它的功能不同于 KCacheGrind，所以这个页面的 KCacheGrind 使用文档章节不适用于这个程序。WinCacheGrind 目前不支持 Xdebug 2.3 引入的 cachegrind 文件格式的的文件和函数压缩。
这也有一种可替代 profile 信息演示的工具叫做 xdebugtoolkit。一款基于 web 前端叫做 Webgrind，和一款基于 java 的工具叫做 XCallGraph。
如果你不能使用 KDE（或者不想使用 KDE）的 kcachegrind 包，可以用 perl 脚本 "ct_annotate"，它能从分析器跟踪文件生成 ASCII 输出。
</div>
<div class="text"> </div>
</div>
<hr></div>
本节介绍Xdebug中可用的所有可用配置设置。
<hr>
<h2>相关设置</h2>
<div class="settings"><hr class="light">
<div class="name">xdebug.auto_trace</div>
类型：布尔值，默认值：0
<div class="description">当此设置设置为on时，将在脚本运行之前启用函数调用的跟踪。这使得跟踪auto_prepend_file中的代码成为可能。</div>
<hr class="light">
<div class="name">xdebug.cli_color</div>
类型：整数，默认值：0，在Xdebug> = 2.2中引入
<div class="description">
如果此设置为1，则Xdebug将在CLI模式下和输出为tty时为var_dumps和堆栈跟踪输出着色。在Windows上， 需要安装ANSICON工具。
如果设置为2，则Xdebug将始终为var_dumps和堆栈跟踪着色，无论它是连接到tty还是安装了ANSICON。在这种情况下，您最终可能会看到转义码。
有关更多信息，请参阅此文章。
</div>
<hr class="light">
<div class="name">xdebug.collect_assignments</div>
类型：布尔值，默认值：0，在Xdebug> = 2.1中引入
<div class="description">
此设置默认为0，控制Xdebug是否应向函数跟踪添加变量赋值。
从Xdebug 2.6开始，<code>=&</code>还包括了by-var（）赋值。
</div>
<hr class="light">
<div class="name">xdebug.collect_includes</div>
类型：布尔值，默认值：1
<div class="description">此设置默认为1，控制Xdebug是否应将include（），include_once（），require（）或require_once（）中使用的文件名写入跟踪文件。</div>
<hr class="light">
<div class="name">xdebug.collect_params</div>
类型：整数，默认值：0
<div class="description">
此设置默认为0，控制Xdebug是否应该在函数跟踪或堆栈跟踪中记录函数调用时收集传递给函数的参数。
该设置默认为0，因为对于非常大的脚本，它可能使用大量内存，因此无法运行巨大的脚本。您可以最安全地打开此设置，但是在脚本中可能会出现一些问题，其中包含大量函数调用和/或大量数据结构作为参数。Xdebug 2不会因内存使用量增加而出现此问题，因为它永远不会将此信息存储在内存中。相反，它只会被写入磁盘。这意味着您需要查看磁盘使用情况。
此设置可以有四个不同的值。对于每个值，显示不同数量的信息。您将在下面看到每个值提供的信息。另请参阅Stack Traces功能的介绍，以 获取一些屏幕截图。
<table class="table">
<tbody>
<tr><th>值</th><th>显示的参数信息</th></tr>
<tr>
<td class="ctr">0</td>
<td>没有。</td>
</tr>
<tr>
<td class="ctr">1</td>
<td>元素的类型和数量（fe string（6），array（8））。</td>
</tr>
<tr>
<td class="ctr">2</td>
<td>
元素的类型和数量，以及完整信息的工具提示1。
</td>
</tr>
<tr>
<td class="ctr">3</td>
<td>完整变量内容（具有xdebug.var_display_max_children，xdebug.var_display_max_data和xdebug.var_display_max_depth设置的限制。</td>
</tr>
<tr>
<td class="ctr">4</td>
<td>完整的变量内容和变量名称。</td>
</tr>
<tr>
<td class="ctr">五</td>
<td>PHP序列化变量内容，没有名称。（Xdebug 2.3中的新功能）</td>
</tr>
</tbody>
</table>
1在PHP的CLI版本，它不会有刀尖，也不在输出文件。
</div>
<hr class="light">
<div class="name">xdebug.collect_return</div>
类型：布尔值，默认值：0
<div class="description">
此设置默认为0，控制Xdebug是否应将函数调用的返回值写入跟踪文件。
对于计算机化的跟踪文件（xdebug.trace_format = 1），这仅适用于Xdebug 2.3以上版本。
</div>
<hr class="light">
<div class="name">xdebug.collect_vars</div>
类型：布尔值，默认值：0
<div class="description">此设置告诉Xdebug收集有关在特定范围内使用哪些变量的信息。由于Xdebug必须对PHP的操作码阵列进行反向工程，因此这种分析可能非常缓慢。此设置不会记录不同变量具有的值，使用xdebug.collect_params。仅当您希望使用xdebug_get_declared_vars（）时，才需要启用此设置 。</div>
<hr class="light">
<div class="name">xdebug.coverage_enable</div>
类型：布尔值，默认值：1，在Xdebug> = 2.2中引入
<div class="description">如果此设置设置为0，则Xdebug将不会设置内部结构以允许代码覆盖。这大大加快了Xdebug的速度，但当然，Code Coverage Analysis不起作用。</div>
<hr class="light">
<div class="name">xdebug.default_enable</div>
类型：布尔值，默认值：1
<div class="description">如果此设置为1，则默认情况下将在错误事件中显示stacktraces。您可以使用xdebug_disable（）禁用代码中的 堆栈跟踪。由于这是Xdebug的基本功能之一，建议将此设置保留为1。</div>
<hr class="light">
<div class="name">xdebug.dump。*</div>
类型：字符串，默认值：空
<div class="description">
*可以是COOKIE，FILES，GET，POST，REQUEST，SERVER，SESSION中的任何一个。当出现错误情况时，这七个设置控制来自超全局的数据。
这些php.ini设置中的每一个都可以包含来自此超全局转储的变量的逗号分隔列表，或者<code>*</code>包含所有变量。确保在此设置中不添加空格。
要在发生错误时转储REMOTE_ADDR和REQUEST_METHOD以及所有GET参数，请添加以下设置：
<pre>xdebug.dump.SERVER = REMOTE_ADDR，REQUEST_METHOD
xdebug.dump.GET = *
</pre>
</div>
<hr class="light">
<div class="name">xdebug.dump_globals</div>
类型：布尔值，默认值：1
<div class="description">当此设置设置为时<code>true</code>，Xdebug会将通过xdebug.dump。*配置的超级全局变量的值添加到屏幕上的堆栈跟踪和错误日志（如果已启用）。</div>
<hr class="light">
<div class="name">xdebug.dump_once</div>
类型：布尔值，默认值：1
<div class="description">控制是否应该在所有错误情况（设置为0）或仅在第一个（设置为1）上转储超全局的值。</div>
<hr class="light">
<div class="name">xdebug.dump_undefined</div>
类型：布尔值，默认值：0
<div class="description">如果要从超全局转储未定义的值，则应将此设置设置为1，否则将其设置为0。</div>
<hr class="light">
<div class="name">xdebug.extended_info</div>
类型：整数，默认值：1
<div class="description">控制Xdebug是否应该为PHP解析器强制执行'extended_info'模式; 这允许Xdebug使用远程调试器执行文件/行断点。在跟踪或分析脚本时，您通常希望关闭此选项，因为PHP生成的oparray将增加大约三分之一的大小，从而减慢脚本速度。无法使用ini_set（）在脚本中设置此设置，但仅在php.ini中设置。</div>
<hr class="light">
<div class="name">xdebug.file_link_format</div>
类型：字符串，默认值：，在Xdebug中引入> = 2.1
<div class="description">
此设置确定在使用文件名的堆栈跟踪显示中生成的链接的格式。这允许IDE设置链接协议，通过单击Xdebug在堆栈跟踪中显示的文件名，可以直接转到行和文件。示例格式可能如下所示：
<pre>myide：//％F @％L
</pre>
可能的格式说明符是：
<table class="table">
<tbody>
<tr><th>符</th><th>含义</th></tr>
<tr>
<td class="ctr">％F</td>
<td>文件名</td>
</tr>
<tr>
<td class="ctr">％L</td>
<td>行号</td>
</tr>
</tbody>
</table>
对于各种IDE / OS，有一些说明如何使这项工作：
<h4>Linux上的Firefox</h4>
<ul>
<li>打开about：config</li>
<li>添加一个新的布尔设置“network.protocol-handler.expose.xdebug”并将其设置为“false”</li>
<li>将以下内容添加到shell脚本中<code>~/bin/ff-xdebug.sh</code>：
<pre>＃！/ bin / sh的

f =`echo $ 1 | cut -d @ -f 1 | sed's / xdebug：\ / \ ///'`
l =`echo $ 1 | 切-d @ -f 2`
</pre>
添加到那个（取决于你是否有komodo，gvim或netbeans）：
<ul>
<li><code>komodo $f -l $l</code></li>
<li><code>gvim --remote-tab +$l $f</code></li>
<li><code>netbeans "$f:$l"</code></li>
</ul>
</li>
<li>使脚本可执行 <code>chmod +x ~/bin/ff-xdebug.sh</code></li>
<li>将xdebug.file_link_format设置为<code>xdebug://%f@%l</code></li>
</ul>
<h4>Windows和netbeans</h4>
<ul>
<li>创建文件<code>netbeans.bat</code>并将其保存在您的路径中（<code>C:\Windows</code>将起作用）：
<pre>@echo关闭
setlocal enableextensions enabledelayedexpansion
设置NETBEANS =％1
设置FILE =％~2
％NETBEANS％ -nosplash --console suppress --open“％FILE：~19％”
nircmd win激活进程netbeans.exe
</pre>
注意：如果没有，请删除最后一行<code>nircmd</code>。
</li>
<li>将以下代码保存为<code>netbeans_protocol.reg</code>：
<pre>Windows注册表编辑器版本5.00


“网址协议”=“”
@ =“URL：Netbeans协议”


@ =“\”C：\\ Program Files \\ NetBeans 7.1.1 \\ bin \\ netbeans.exe，1 \“”






@ =“\”C：\\ Windows \\ netbeans.bat \“\”C：\\ Program Files \\ NetBeans 7.1.1 \\ bin \\ netbeans.exe \“\”％1 \“”
</pre>
注意：确保将路径更改为Netbeans（两次），以及<code>netbeans.bat</code>批处理文件，如果您将其保存在其他位置<code>C:\Windows\</code>。
</li>
<li>双击该<code>netbeans_protocol.reg</code>文件将其导入注册表。</li>
<li>将xdebug.file_link_format设置为<code>xdebug.file_link_format = "netbeans://open/?f=%f:%l"</code></li>
</ul>
</div>
<hr class="light">
<div class="name">xdebug.filename_format</div>
类型：字符串，默认值：...％s％n，在Xdebug中引入> = 2.6
<div class="description">
此设置确定Xdebug <code>...%s%n</code>通过重载的xdebug_var_dump（）（默认值 :)在HTML堆栈跟踪（默认值:)和位置信息中呈现文件名的格式<code>%f</code>。
此表中列出了可能的格式说明符。示例输出根据完整路径呈现 <code>/var/www/vendor/mail/transport/mta.php</code>。
<table class="table">
<tbody>
<tr><th>符</th><th>含义</th><th>示例输出</th></tr>
<tr>
<td class="ctr">％一种</td>
<td>Ancester：两个目录元素和文件名</td>
<td><code>mail/transport/mta.php</code></td>
</tr>
<tr>
<td class="ctr">％F</td>
<td>完整路径</td>
<td><code>/var/www/vendor/mail/transport/mta.php</code></td>
</tr>
<tr>
<td class="ctr">％N</td>
<td>名称：仅文件名</td>
<td><code>mta.php</code></td>
</tr>
<tr>
<td class="ctr">％p</td>
<td>父：一个目录元素和文件名</td>
<td><code>transport/mta.php</code></td>
</tr>
<tr>
<td class="ctr">％S</td>
<td>目录分隔符</td>
<td><code>\</code>在Linux，OSX和其他类Unix系统上，<code>/</code>在Windows上</td>
</tr>
</tbody>
</table>
</div>
<hr class="light">
<div class="name">xdebug.force_display_errors</div>
类型：int，默认值：0，在Xdebug中引入> = 2.3
<div class="description">
如果将此设置设置为，<code>1</code>则无论PHP的display_errors设置如何，都将始终显示错误 。
</div>
<hr class="light">
<div class="name">xdebug.force_error_reporting</div>
类型：int，默认值：0，在Xdebug中引入> = 2.3
<div class="description">
此设置是一个位掩码，如error_reporting。该位掩码将与error_reporting to dermine 表示的位掩码逻辑OR运算，应显示错误。此设置只能在php.ini中进行，并允许您强制显示某些错误，无论应用程序使用ini_set（）做什么。
</div>
<hr class="light">
<div class="name">xdebug.halt_level</div>
类型：int，默认值：0，在Xdebug中引入> = 2.3
<div class="description">
此设置允许您配置一个掩码，用于确定是否以及哪些通知和/或警告转换为错误。您可以配置由PHP生成的通知和警告，以及您自己生成的通知和警告（通过trigger_error（））。例如，要将strlen（）（不带参数）的警告转换为错误，您可以执行以下操作：
<pre>ini_set（'xdebug.halt_level'，E_WARNING）;
的strlen（）;
回声“嗨！\ n”;
</pre>
然后，这将导致显示错误消息和脚本的中止。<code>echo "Hi!\n";</code>不会被执行。
该设置是一个位掩码，因此要将所有通知和警告转换为所有应用程序的错误，您可以在php.ini中设置：
<pre>xdebug.halt_level = E_WARNING | E_NOTICE | E_USER_WARNING | E_USER_NOTICE
</pre>
位掩码仅支持上面提到的四个级别。
</div>
<hr class="light">
<div class="name">xdebug.idekey</div>
类型：字符串，默认值：* complex *
<div class="description">控制哪些IDE Key Xdebug应传递给DBGp调试器处理程序。默认值基于环境设置。首先查阅环境设置DBGP_IDEKEY，然后是USER和最后一个USERNAME。默认设置为找到的第一个环境变量。如果找不到任何设置，则设置为默认值''。如果设置了此设置，它将始终覆盖环境变量。</div>
<hr class="light">
<div class="name">xdebug.manual_url</div>
类型：字符串，默认值：http：//www.php.net，在Xdebug <2.2.1中引入
<div class="description">这是从函数跟踪和错误消息到消息中函数的手册页的链接的基本URL。建议将此设置设置为使用最近的镜像。</div>
<hr class="light">
<div class="name">xdebug.max_nesting_level</div>
类型：整数，默认值：256
<div class="description">
控制无限递归保护的保护机制。此设置的值是在中止脚本之前允许的嵌套函数的最大级别。
在Xdebug 2.6之前，如果超出，这将产生致命的异常。从Xdebug 2.6及更高版本开始，将引发“ 错误 ”异常。
在Xdebug 2.3之前，默认值为<code>100</code>。
</div>
<hr class="light">
<div class="name">xdebug.max_stack_frames</div>
类型：整数，默认值：-1，在Xdebug中引入> = 2.3
<div class="description">
控制堆栈跟踪中显示的堆栈帧数，在PHP错误堆栈跟踪期间在命令行上以及在HTML跟踪的浏览器中显示。
</div>
<hr class="light">
<div class="name">xdebug.overload_var_dump</div>
类型：布尔值，默认值：2，在Xdebug> 2.1中引入
<div class="description">
默认情况下，当html_errors php.ini设置为<code>1</code>或时，Xdebug会使用自己的改进版本重载var_dump（）以显示变量 <code>2</code>。如果你不想这样，你可以将此设置设置为<code>0</code>，但首先检查是否关闭html_errors并不聪明。
您还可以<code>2</code>将此设置用作值。除了很好地格式化var_dump（）输出外，它还会在输出中添加文件名和行号。该xdebug.file_link_format设置也很尊敬。（Xdebug 2.3中的新功能）
在Xdebug 2.4之前，此设置的默认值为 <code>1</code>。
</div>
<hr class="light">
<div class="name">xdebug.profiler_aggregate</div>
类型：整数，默认值：0
<div class="description">当此设置设置为1时，将为多个请求写入一个探查器文件。可以浏览多个页面或重新加载页面以获得所有请求的平均值。该文件将被命名 <code>.cachegrind.aggregate</code>。您需要移动此文件以获取另一轮聚合数据。</div>
<hr class="light">
<div class="name">xdebug.profiler_append</div>
类型：整数，默认值：0
<div class="description">当此设置设置为1时，如果新请求映射到同一文件，则不会覆盖探查器文件（取决于xdebug.profiler_output_name设置。而是将文件附加到新配置文件中。</div>
<hr class="light">
<div class="name">xdebug.profiler_enable</div>
类型：整数，默认值：0
<div class="description">启用Xdebug的分析器，该分析器在配置文件输出目录中创建文件 。KCacheGrind可以读取这些文件以可视化您的数据。无法使用ini_set（）在脚本中设置此设置。如果要有选择地启用探查器，请将xdebug.profiler_enable_trigger设置为1 而不是使用此设置。</div>
<hr class="light">
<div class="name">xdebug.profiler_enable_trigger</div>
类型：整数，默认值：0
<div class="description">当此设置设置为1时，您可以使用XDEBUG_PROFILE GET / POST参数触发生成探查器文件，或者设置名为XDEBUG_PROFILE的cookie。然后，这将将探查器数据写入 定义的目录。为了防止探查器为每个请求生成配置文件，您需要将xdebug.profiler_enable设置 为0.可以通过xdebug.profiler_enable_trigger_value配置对触发器本身的访问。</div>
<hr class="light">
<div class="name">xdebug.profiler_enable_trigger_value</div>
类型：字符串，默认值：“”，在Xdebug中引入> = 2.3
<div class="description">此设置可用于限制谁可以使用xdebug.profiler_enable_trigger中概述的XDEBUG_PROFILE功能。当从其空字符串的默认值更改时，cookie，GET或POST参数的值需要与此设置的共享密钥集匹配，以便启动探查器。</div>
<hr class="light">
<div class="name">xdebug.profiler_output_dir</div>
键入：字符串，默认值：/ tmp
<div class="description">将编译探测器输出的目录，确保将运行PHP的用户具有对该目录的写入权限。无法使用ini_set（）在脚本中设置此设置。</div>
<hr class="light">
<div class="name">xdebug.profiler_output_name</div>
键入：字符串，默认值：cachegrind.out。％p
<div class="description">
此设置确定用于将跟踪转储到的文件的名称。该设置指定格式说明符的格式，与sprintf（）和strftime（）非常相似。有几种格式说明符可用于格式化文件名。
有关支持的说明符，请参阅xdebug.trace_output_name文档。
</div>
<hr class="light">
<div class="name">xdebug.remote_addr_header</div>
类型：字符串，默认值：“”，在Xdebug中引入> = 2.4
<div class="description">如果xdebug.remote_addr_header配置为非空字符串，则该值将用作$ SERVER超全局数组中的键，以确定用于查找用于“连接回”的IP地址或主机名的标头。此设置仅与xdebug.remote_connect_back结合使用 ，否则将被忽略。
 
</div>
<hr class="light">
<div class="name">xdebug.remote_autostart</div>
类型：布尔值，默认值：0
<div class="description">通常，您需要使用特定的HTTP GET / POST变量来启动远程调试（请参阅远程调试）。当此设置设置为1时，即使GET / POST / COOKIE变量不存在，Xdebug也将始终尝试启动远程调试会话并尝试连接到客户端。</div>
<hr class="light">
<div class="name">xdebug.remote_connect_back</div>
类型：布尔值，默认值：0，在Xdebug> = 2.1中引入
<div class="description">
如果启用，则忽略xdebug.remote_host设置，Xdebug将尝试连接到发出HTTP请求的客户端。它检查$ _SERVER ['HTTP_X_FORWARDED_FOR']和$ _SERVER ['REMOTE_ADDR']变量以找出要使用的IP地址。
如果配置了xdebug.remote_addr_header，则将在$ _SERVER ['HTTP_X_FORWARDED_FOR']和$ _SERVER ['REMOTE_ADDR']变量之前检查具有已配置名称的$ SERVER变量。
此设置不适用于通过CLI进行调试，因为$ SERVER标头变量在那里不可用。
请注意，没有可用的过滤器，任何可以连接到Web服务器的人都可以启动调试会话，即使他们的地址与xdebug.remote_host不匹配 。
</div>
<hr class="light">
<div class="name">xdebug.remote_cookie_expire_time</div>
类型：整数，默认值：3600，在Xdebug> = 2.1中引入
<div class="description">此设置可用于通过会话cookie增加（或减少）远程调试会话保持活动的时间。</div>
<hr class="light">
<div class="name">xdebug.remote_enable</div>
类型：布尔值，默认值：0
<div class="description">此开关控制Xdebug是否应尝试联系正在侦听主机和端口的调试客户端，并使用设置xdebug.remote_host和 xdebug.remote_port进行设置 。如果无法建立连接，脚本将继续，就像此设置为0一样。</div>
<hr class="light">
<div class="name">xdebug.remote_handler</div>
键入：字符串，默认值：dbgp
<div class="description">
可以是'php3'，它选择旧的PHP 3样式调试器 输出，'gdb'，它启用GDB，如调试器接口或'dbgp' - 调试器协议。DBGp协议是唯一受支持的协议。
注意：Xdebug 2.1及更高版本仅支持'dbgp'作为协议。
</div>
<hr class="light">
<div class="name">xdebug.remote_host</div>
键入：字符串，默认值：localhost
<div class="description">
选择运行调试客户端的主机，您可以使用主机名，IP地址或Unix域套接字的“unix：/// path / to / sock”。如果启用了xdebug.remote_connect_back，则忽略此设置。
Xdebug 2.6中引入了对Unix域套接字的支持。
</div>
<hr class="light">
<div class="name">xdebug.remote_log</div>
类型：字符串，默认值：
<div class="description">如果设置为值，则将其用作记录所有远程调试器通信的文件的文件名。该文件始终以append-mode打开，因此默认情况下不会被覆盖。没有可用的并发保护。该文件的格式如下所示：
<pre>登录于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>
</pre>
</div>
<hr class="light">
<div class="name">xdebug.remote_mode</div>
键入：字符串，默认值：req
<div class="description">
选择启动调试连接的时间。此设置可以有两个不同的值：
<dl><dt>REQ</dt><dd>一旦脚本启动，Xdebug将尝试连接到调试客户端。</dd><dt>JIT</dt><dd>一旦出现错误情况，Xdebug将仅尝试连接到调试客户端。</dd></dl></div>
<hr class="light">
<div class="name">xdebug.remote_port</div>
类型：整数，默认值：9000
<div class="description">Xdebug尝试在远程主机上连接的端口。端口9000是客户端和捆绑的调试客户端的默认端口。由于许多客户端使用此端口号，因此最好不要更改此设置。</div>
<hr class="light">
<div class="name">xdebug.remote_timeout</div>
类型：整数，默认值：200，在Xdebug中引入> = 2.6
<div class="description">
Xdebug在IDE上等待确认传入调试连接的时间量（以毫秒为单位）。在大多数情况下，默认值200 ms应该足够了。如果您经常遇到调试请求丢失，可能是因为您有一个高延迟网络，或远离IDE的开发盒，或者防火墙速度慢，那么您可以增加此值。
请注意，增加此值可能意味着在Xdebug尝试建立连接但您的IDE未侦听时，您的请求似乎“挂起”。
</div>
<hr class="light">
<div class="name">xdebug.scream</div>
类型：布尔值，默认值：0，在Xdebug> = 2.1中引入
<div class="description">如果此设置为1，则Xdebug将禁用@（关闭）运算符，以便不再隐藏通知，警告和错误。</div>
<hr class="light">
<div class="name">xdebug.show_error_trace</div>
类型：整数，默认值：0，在Xdebug> = 2.4中引入
<div class="description">当此设置设置为1时，只要出现错误，Xdebug就会显示堆栈跟踪 - 即使实际捕获到此错误。</div>
<hr class="light">
<div class="name">xdebug.show_exception_trace</div>
类型：整数，默认值：0
<div class="description">
当此设置设置为1时，Xdebug将在引发异常或错误时显示堆栈跟踪 - 即使实际捕获到此异常或错误。
PHP 7中引入了错误“异常”。
</div>
<hr class="light">
<div class="name">xdebug.show_local_vars</div>
类型：整数，默认值：0
<div class="description">当此设置设置为某个值时！= 0 Xdebug在错误情况下生成的堆栈转储也将显示最顶层范围内的所有变量。请注意，这可能会生成大量信息，因此默认情况下处于关闭状态。</div>
<hr class="light">
<div class="name">xdebug.show_mem_delta</div>
类型：整数，默认值：0
<div class="description">当此设置设置为某个值时！= 0 Xdebug的人类可读生成的跟踪文件将显示函数调用之间的内存使用量差异。如果Xdebug配置为生成计算机可读的跟踪文件，那么它们将始终显示此信息。</div>
<hr class="light">
<div class="name">xdebug.trace_enable_trigger</div>
类型：布尔值，默认值：0，在Xdebug> = 2.2中引入
<div class="description">当此设置设置为1时，您可以使用XDEBUG_TRACE GET / POST参数触发跟踪文件的生成，或者设置名为XDEBUG_TRACE的cookie。然后，这将跟踪数据写入 定义的目录。为了防止Xdebug为每个请求生成跟踪文件，您需要将xdebug.auto_trace设置 为0.可以通过xdebug.trace_enable_trigger_value配置对触发器本身的访问 。</div>
<hr class="light">
<div class="name">xdebug.trace_enable_trigger_value</div>
类型：字符串，默认值：“”，在Xdebug中引入> = 2.3
<div class="description">这个设置可以用来限制谁可以使用的XDEBUG_TRACE功能中概述xdebug.trace_enable_trigger。当从其空字符串的默认值更改时，cookie，GET或POST参数的值需要与此设置的共享密钥集匹配，以便生成跟踪文件。</div>
<hr class="light">
<div class="name">xdebug.trace_format</div>
类型：整数，默认值：0
<div class="description">
跟踪文件的格式。
<table class="table">
<tbody>
<tr><th>值</th><th>描述</th></tr>
<tr>
<td class="ctr">0</td>
<td>显示一个人类可读的缩进跟踪文件，其中包括： 时间索引，内存使用情况，内存增量（如果启用了设置xdebug.show_mem_delta），级别，函数名称， 函数参数（如果启用了设置xdebug.collect_params）， 文件名和行号。</td>
</tr>
<tr>
<td class="ctr">1</td>
<td>写一种具有两种不同记录的计算机可读格式。输入堆栈帧并留下堆栈帧有不同的记录。下表列出了每种记录类型中的字段。字段按制表符分隔。</td>
</tr>
<tr>
<td class="ctr">2</td>
<td>写一个用（简单）HTML格式化的跟踪。</td>
</tr>
</tbody>
</table>
计算机化格式的字段：
<table class="table">
<tbody>
<tr><th>记录类型</th><th class="ctr">1</th><th class="ctr">2</th><th class="ctr">3</th><th class="ctr">4</th><th class="ctr">五</th><th class="ctr">6</th><th class="ctr">7</th><th class="ctr">8</th><th class="ctr">9</th><th class="ctr">10</th><th class="ctr">11</th><th class="ctr">12 - ......</th></tr>
<tr><th class="ctr">条目</th>
<td>水平</td>
<td>功能＃</td>
<td>总是'0'</td>
<td>时间指数</td>
<td>内存使用情况</td>
<td>功能名称</td>
<td>用户定义的（1）或内部函数（0）</td>
<td>包含/要求文件的名称</td>
<td>文档名称</td>
<td>电话号码</td>
<td>没有。参数</td>
<td>参数（与字段11中指定的数量一样多） - 制表符分隔</td>
</tr>
<tr><th class="ctr">出口</th>
<td>水平</td>
<td>功能＃</td>
<td>总是'1'</td>
<td>时间指数</td>
<td>内存使用情况</td>
<td class="ctr" colspan="7">空</td>
</tr>
<tr><th class="ctr">返回</th>
<td>水平</td>
<td>功能＃</td>
<td>总是'R'</td>
<td class="ctr" colspan="2">空</td>
<td>回报价值</td>
<td class="ctr" colspan="6">空</td>
</tr>
</tbody>
</table>
有关示例，请参阅功能跟踪的介绍。
</div>
<hr class="light">
<div class="name">xdebug.trace_options</div>
类型：整数，默认值：0
<div class="description">设置为“1”时，将追加跟踪文件，而不是在后续请求中覆盖。</div>
<hr class="light">
<div class="name">xdebug.trace_output_dir</div>
键入：字符串，默认值：/ tmp
<div class="description">将写入跟踪文件的目录，确保将运行PHP的用户具有对该目录的写入权限。</div>
<hr class="light">
<div class="name">xdebug.trace_output_name</div>
类型：字符串，默认值：trace。％c
<div class="description">
此设置确定用于将跟踪转储到的文件的名称。该设置指定格式说明符的格式，与sprintf（）和strftime（）非常相似。有几种格式说明符可用于格式化文件名。始终会自动添加“.xt”扩展名。
可能的格式说明符是：
<table class="table">
<tbody>
<tr><th>符</th><th>含义</th><th>示例格式</th><th>示例文件名</th></tr>
<tr>
<td class="ctr">％C</td>
<td>当前工作目录的crc32</td>
<td>跟踪％C</td>
<td>trace.1258863198.xt</td>
</tr>
<tr>
<td class="ctr">％p</td>
<td>PID</td>
<td>跟踪。％P</td>
<td>trace.5174.xt</td>
</tr>
<tr>
<td class="ctr">％R</td>
<td>随机数</td>
<td>跟踪。％R</td>
<td>trace.072db0.xt</td>
</tr>
<tr>
<td class="ctr">％S</td>
<td>
脚本名称2
</td>
<td>cachegrind.out％S</td>
<td>cachegrind.out._home_httpd_html_test_xdebug_test_php</td>
</tr>
<tr>
<td class="ctr">％T</td>
<td>时间戳（秒）</td>
<td>追查。％T</td>
<td>trace.1179434742.xt</td>
</tr>
<tr>
<td class="ctr">％u</td>
<td>时间戳（微秒）</td>
<td>跟踪。％u</td>
<td>trace.1179434749_642382.xt</td>
</tr>
<tr>
<td class="ctr">％H</td>
<td>$ _ SERVER [ 'HTTP_HOST']</td>
<td>跟踪。％H</td>
<td>trace.kossu.xt</td>
</tr>
<tr>
<td class="ctr">％R</td>
<td>$ _ SERVER [ 'REQUEST_URI']</td>
<td>跟踪。％R</td>
<td>trace._test_xdebug_test_php_var = 1_var2 = 2.xt</td>
</tr>
<tr>
<td class="ctr">％U</td>
<td>$ _SERVER ['UNIQUE_ID'] 3</td>
<td>跟踪。％U</td>
<td>trace.TRX4n38AAAEAAB9gBFkAAAAB.xt</td>
</tr>
<tr>
<td class="ctr">％S</td>
<td>session_id（如果设置，则来自$ _COOKIE）</td>
<td>追查。％S</td>
<td>trace.c70c1ec2375af58f74b390bbdd2a679d.xt</td>
</tr>
<tr>
<td class="ctr">%%</td>
<td>字面％</td>
<td>跟踪。％％</td>
<td>跟踪%%。XT</td>
</tr>
</tbody>
</table>
2此版本仅适用于自Xdebug 2.6以来的跟踪文件名。
3版本2.2中的新功能。这个是由Apache的mod_unique_id模块设置的
</div>
<hr class="light">
<div class="name">xdebug.var_display_max_children</div>
类型：整数，默认值：128
<div class="description">
当使用xdebug_var_dump（）， xdebug.show_local_vars或通过函数跟踪显示变量时，控制数组子项的数量和对象的属性。
要禁用任何限制，请使用-1作为值。
此设置对通过“ 远程调试”功能发送给客户端的子节点数没有任何影响。
</div>
<hr class="light">
<div class="name">xdebug.var_display_max_data</div>
类型：整数，默认值：512
<div class="description">
控制使用xdebug_var_dump（）， xdebug.show_local_vars或通过函数跟踪显示变量时显示的最大字符串长度。
要禁用任何限制，请使用-1作为值。
此设置对通过“ 远程调试”功能发送给客户端的子节点数没有任何影响。
</div>
<hr class="light">
<div class="name">xdebug.var_display_max_depth</div>
类型：整数，默认值：3
<div class="description">
控制使用xdebug_var_dump（）， xdebug.show_local_vars或通过函数跟踪显示变量时，有多少嵌套级别的数组元素和对象属性。
您可以选择的最大值是1023.您还可以使用-1作为值来选择此最大数字。
此设置对通过“ 远程调试”功能发送给客户端的子节点数没有任何影响。
 
<h2>配置举例</h2>
php.ini中：
<div class="cnblogs_code">
<pre>;pecl install xdebug-2.4.1

zend_extension=/usr/local/sinawap/apps/php-cms-5.4.45/lib/php/extensions/no-debug-non-zts-20100525/xdebug.so
xdebug.remote_enable = On
xdebug.remote_handler = "dbgp"
xdebug.remote_host = "10.222.22..."#修改下
xdebug.remote_port = 9000
xdebug.idekey = IDEA
xdebug.profiler_output_dir = "/data1/profiler"
xdebug.profiler_enable = 0
xdebug.profiler_enable_trigger = 1
xdebug.profiler_enable_trigger_value=SINA_SCP
xdebug.trace_enable_trigger = 1
xdebug.trace_enable_trigger_value=SINA_SCP
xdebug.trace_output_dir=/data1/profiler
xdebug.show_mem_delta=1
xdebug.collect_params=4
xdebug.collect_return=1
xdebug.trace_format=1</pre>
</div>
配置完成之后重启 <code>php-fpm</code> 
<h2 id="articleHeader3">安装 xdebug 工具</h2>
安装 chrome 扩展 Xdebug helper
<img src="https://img2018.cnblogs.com/blog/420532/201909/420532-20190920114719078-1058141536.png" alt="">
 
 
<h2 id="articleHeader4">启用 Xdebug helper 的 profiler 工具</h2>
<img src="https://img2018.cnblogs.com/blog/420532/201909/420532-20190920113134952-583030793.png" alt="">
 
 
<img title="" src="https://segmentfault.com/img/remote/1460000011401010?w=166&h=230" alt="" data-src="/img/remote/1460000011401010?w=166&h=230">
<h2 id="articleHeader5">刷新页面, 查看设定的文件夹</h2>
在上边设定的文件夹中会生成 profiler 文件 <img title="" src="https://segmentfault.com/img/remote/1460000011401011?w=247&h=57" alt="" data-src="/img/remote/1460000011401011?w=247&h=57">
<h2 id="articleHeader6">使用工具来分析 profiler 文件</h2>
这里我使用 phpstorm 的分析工具来查看
<code>Tools > Analyze Xdebug Profiler Snapshot</code>
选择生成的输出文件, 可以看到文件的解析信息, 这个对于分析自己写的php代码会有很大益处
<img src="https://img2018.cnblogs.com/blog/420532/201909/420532-20190920114534833-2002144207.png" alt="">
 
 
 
 
<h2>使用IDEA/PHPStorm来debug</h2>
设置断点
按红线内设置
 <img src="https://img2018.cnblogs.com/blog/420532/201909/420532-20190920114925935-267639159.png" alt="">
 
 
 RUN->"Start listening for PHP Debug Connection"
选择“Debug”
<img src="https://img2018.cnblogs.com/blog/420532/201909/420532-20190920113648843-482248799.png" alt="">
 
 
 选择之前断点的文件<img src="https://img2018.cnblogs.com/blog/420532/201909/420532-20190920113724301-2014680136.png" alt="">
 
开始 debug
<img src="https://img2018.cnblogs.com/blog/420532/201909/420532-20190920113856820-1941079570.png" alt="">
 
<h2>使用Webgrind分析profile</h2>
安装、使用： https://github.com/jokkedk/webgrind
<img src="https://img2018.cnblogs.com/blog/420532/201909/420532-20190920114407796-325021734.png" alt="">
 
 
<img src="https://img2018.cnblogs.com/blog/420532/201909/420532-20190920114421964-1878622854.png" alt="">
 
 
 

</div>

</div>

</div>
<div id="MySignature" role="contentinfo">
本文来自博客园，作者：sunsky303，转载请注明原文链接：https://www.cnblogs.com/sunsky303/p/11556013.html 
来源：https://www.cnblogs.com/sunsky303/p/11556013.html

頁: [1]

琼殿技术论坛's Archiver

php xdebug的配置、调试、跟踪、调优、分析