Xdebugドキュメント (1) 基本機能

基本属性 (パラメータ)

xdebug.default_enable

タイプ: ブール値、デフォルト値: 1

これは、xdebug の基本設定です。デフォルトでは、デバッグ トレース中にエラー情報が表示されます。 xdebug_disable() 関数を使用すると、コード内のデバッグ表示を無効にすることができます。

xdebug.force_display_errors

タイプ: int、デフォルト値: 0、Xdebug バージョン 2.3

この設定が 1 に設定されている場合、PHP 設定の display_errors 設定値に関係なく、エラーが発生した場合、情報は常に強制的に表示されます。

xdebug.force_error_reporting

タイプ: int、デフォルト値: 0、Xdebug バージョン 2.3 以降

これは、error_reporting に似たマスク値で、論理和または関係を使用してマスク値を整理し、どのエラーを表示するかどうかを決定します。この設定は php.ini でのみ構成でき、ini_set() 関数では使用できません。

xdebug.halt_level

タイプ: int、デフォルト値: 0、Xdebug バージョン 2.3 以降

この設定値は、どの種類のエラーを変換するかを決定するマスク値となります。 4 つのレベルの設定をサポートします:

xdebug.halt_level=E_WARNING|E_NOTICE|E_USER_WARNING|E_USER_NOTICE<br><br><br>

xdebug.max_nesting_level

タイプ: 整数、デフォルト値: 256 (2.3 より前のバージョンのデフォルト値は 100)

この設定により、スクリプトが停止する前にネストされた関数を最大レベルで実行できます。

xdebug.scream

タイプ: ブール値、デフォルト値: 0、Xdebug バージョン>= 2.1

该值若设置为1，则xdebug将显示标识@符号的语句的通知、警告和错误，并不再隐藏。

 

 

相关的函数：

 

string xdebug_call_file()

返回当前执行此函数所在的文件名。

 

string xdebug_call_function()

返回当前函数被调用执行时的函数来源名称。

 

int xdebug_call_line()

返回当前执行的行号。

 

示例：

Example:

<?<span style="color: #000000;">php
    </span><span style="color: #0000ff;">function</span> fix_string(<span style="color: #800080;">$a</span><span style="color: #000000;">)
    {
        </span><span style="color: #0000ff;">echo</span> "Called @ ".<span style="color: #000000;">
            xdebug_call_file()</span>.
            ":".<span style="color: #000000;">
            xdebug_call_line()</span>.
            " from ".<span style="color: #000000;">
            xdebug_call_function();
    }

    </span><span style="color: #800080;">$ret</span> = fix_string(<span style="color: #0000ff;">array</span>('Derick'<span style="color: #000000;">));
</span>?>

<span style="color: #008000;">//</span><span style="color: #008000;"> Called @ /home/httpd/html/test/xdebug_caller.php:12 from {main}</span>

 

string xdebug_call_class()

返回调用的类名。

 

void xdebug_disable()

不显示错误跟踪信息。

 

void xdebug_enable()

显示错误跟踪信息。

 

string xdebug_get_collected_errors( [int clean] )

始于版本 2.1

该函数返回所有收集的错误信息，这些信息以表格形式格式化。

错误信息的收集起始点，使用函数xdebug_start_error_collection()决定。

默认情况下该函数不会清空错误信息收集缓存，你可以设置参数为true则缓存会清空。

 

array xdebug_get_headers()

以数组方式返回所有header信息，凡是调用了header()函数设置的头部信息都会返回。

<?<span style="color: #000000;">php
</span><span style="color: #008080;">header</span>( "X-Test", "Testing"<span style="color: #000000;"> );
</span><span style="color: #008080;">setcookie</span>( "TestCookie", "test-value"<span style="color: #000000;"> );
</span><span style="color: #008080;">var_dump</span><span style="color: #000000;">( xdebug_get_headers() );
</span>?>

<span style="color: #008000;">/*</span><span style="color: #008000;">*
Returns:

array(2) {
  [0]=>
  string(6) "X-Test"
  [1]=>
  string(33) "Set-Cookie: TestCookie=test-value"
}
</span><span style="color: #008000;">*/</span>

bool xdebug_is_enabled()

检测调试跟踪是否有效。

 

int xdebug_memory_usage()

返回脚本对内存使用量。PHP5.2.1之前编译的版本必须附带--enable-memory-limit参数才有效，在这之后的版本则一直有效。

 

int xdebug_peak_memory_usage()

返回内存使用的最高值。PHP5.2.1之前编译的版本必须附带--enable-memory-limit参数才有效，在这之后的版本则一直有效。

 

void xdebug_start_error_collection()

始于版本 2.1

该函数一执行，PHP将不再显示任何通知警告和错误信息，这些信息将会存入一缓存中，除非执行到xdebug_stop_error_collection()才会停止。

缓存中的错误信息内容可以通过xdebug_get_collected_errors()函数获取。

 

void xdebug_stop_error_collection()

始于版本2.1

与xdebug_start_error_collection()相对，它会停止收集所有通知、警告和错误信息。注意，它不会清除收集错误的缓存。

 

float xdebug_time_index()

返回当前的时间索引，即从脚本开始运行后的秒数，以浮点数表示。

<?<span style="color: #000000;">php
</span><span style="color: #0000ff;">echo</span> xdebug_time_index(), "\n"<span style="color: #000000;">;
</span><span style="color: #0000ff;">for</span> (<span style="color: #800080;">$i</span> = 0; <span style="color: #800080;">$i</span> < 250000; <span style="color: #800080;">$i</span>++<span style="color: #000000;">)
{
    </span><span style="color: #008000;">//</span><span style="color: #008000;"> do nothing</span>
<span style="color: #000000;">}
</span><span style="color: #0000ff;">echo</span> xdebug_time_index(), "\n"<span style="color: #000000;">;
</span>?>
<span style="color: #008000;">/*</span><span style="color: #008000;">*
Returns:

0.00038003921508789
0.76580691337585
</span><span style="color: #008000;">*/</span>