成人精品一区二区三区中文字幕-成人精品一区二区三区-成人精品一级毛片-成人精品亚洲-日本在线视频一区二区-日本在线视频免费

(PHP 4 >= 4.3.0, PHP 5)

debug_backtrace — 產生一條回溯跟蹤(backtrace)

說明

debug_backtrace() 產生一條 PHP 的回溯跟蹤(backtrace)。

參數

options

截至 5.3.6，這個參數是以下選項的位掩碼： debug_backtrace() 選項 DEBUG_BACKTRACE_PROVIDE_OBJECT 是否填充 "object" 的索引。 DEBUG_BACKTRACE_IGNORE_ARGS 是否忽略 "args" 的索引，包括所有的 function/method 的參數，能夠節省內存開銷。 在 5.3.6 之前，僅僅能使用的值是 TRUE 或者 FALSE，分別等于是否設置 DEBUG_BACKTRACE_PROVIDE_OBJECT 選項。

截至 5.4.0，這個參數能夠用于限制返回堆棧幀的數量。 默認為 (limit=0) ，返回所有的堆棧幀。

返回值

返回一個包含眾多關聯數組的 array。 以為為有可能返回的元素：

有可能從 debug_backtrace() 返回的元素 名字 類型 說明 function string 當前的函數名，參見： __FUNCTION__。 line integer 當前的行號。參見： __LINE__。 file string 當前的文件名。參見： __FILE__。 class string 當前 class 的名稱。參見 __CLASS__ object object 當前的 object。 type string 當前調用的類型。如果是一個方法，會返回 "->"。如果是一個靜態方法，會返回 "::"。 如果是一個函數調用，則返回空。 args array 如果在一個函數里，這會列出函數的參數。 如果是在一個被包含的文件里，會列出包含的文件名。

更新日志

版本 說明 5.4.0 添加了可選的參數 limit。 5.3.6 參數 provide_object 改成 options，并且增加了可選參數 DEBUG_BACKTRACE_IGNORE_ARGS。 5.2.5 添加了可選參數 provide_object。 5.1.1 添加了當前的 object 為可能返回的元素。

范例

Example #1 debug_backtrace() 范例

<?php
// filename: /tmp/a.php

function a_test($str)
{
    echo "nHi: $str";
    var_dump(debug_backtrace());
}

a_test('friend');
?>

<?php
// filename: /tmp/b.php
include_once '/tmp/a.php';
?>

執行 /tmp/b.php 返回的結果類似于以下：

Hi: friend
array(2) {
[0]=>
array(4) {
    ["file"] => string(10) "/tmp/a.php"
    ["line"] => int(10)
    ["function"] => string(6) "a_test"
    ["args"]=>
    array(1) {
      [0] => &string(6) "friend"
    }
}
[1]=>
array(4) {
    ["file"] => string(10) "/tmp/b.php"
    ["line"] => int(2)
    ["args"] =>
    array(1) {
      [0] => string(10) "/tmp/a.php"
    }
    ["function"] => string(12) "include_once"
  }
}

參見

trigger_error() - 產生一個用戶級別的 error/warning/notice 信息 debug_print_backtrace() - 打印一條回溯。