debug_backtrace() - php 错误处理日志函数
debug_backtrace()
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
产生一条回溯跟踪(backtrace)
说明
debug_backtrace([int $options= DEBUG_BACKTRACE_PROVIDE_OBJECT[,int $limit= 0]]): arraydebug_backtrace()产生一条 PHP 的回溯跟踪(backtrace)。
参数
$options截至 5.3.6,这个参数是以下选项的位掩码:
DEBUG_BACKTRACE_PROVIDE_OBJECT | 是否填充"object"的索引。 |
DEBUG_BACKTRACE_IGNORE_ARGS | 是否忽略"args"的索引,包括所有的 function/method 的参数,能够节省内存开销。 |
TRUE
或者FALSE
,分别等于是否设置DEBUG_BACKTRACE_PROVIDE_OBJECT
选项。$limit截至 5.4.0,这个参数能够用于限制返回堆栈帧的数量。默认为($limit=0),返回所有的堆栈帧。
返回值
返回一个包含众多关联数组的array。以为为有可能返回的元素:
名字 | 类型 | 说明 |
---|---|---|
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 #1debug_backtrace()范例
执行/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()
打印一条回溯。
Here's a function I just wrote for getting a nice and comprehensible call trace. It is probably more resource-intensive than some other alternatives but it is short, understandable, and gives nice output (Exception->getTraceAsString()). Example output: 1) /var/www/test/test.php(15): SomeClass->__construct() 2) /var/www/test/SomeClass.class.php(36): SomeClass->callSomething()
Just a short note on debug_backtrace options for PHP 5.3.6 or newer: debug_backtrace() - show all options debug_backtrace(0) - exlude ["object"] debug_backtrace(1) - same as debug_backtrace() debug_backtrace(2) - exlude ["object"] AND ["args"] use this example and try calling debug_backtrace with different options
If you are using the backtrace function in an error handler, avoid using var_export() on the args, as you will cause fatal errors in some situations, preventing you from seeing your stack trace. Some structures will cause PHP to generate the fatal error "Nesting level too deep - recursive dependency?" This is a design feature of php, not a bug (see http://bugs.php.net/bug.php?id=30471)
Simple function to get a string in form "filename: [class->][function(): ]" Usage like: get_caller_info() will return info about the function /class->method that called debug().
When using debug_backtrace() to check if you're being accessed from another caller, please remember to ask debug_backtrace to only go as far as needed in depth and skip taking the entire debug object as return parameter:
One line of code to print simplest and shortest human readable backtrace:)
鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com
免责声明:我们致力于保护作者版权,注重分享,当前被刊用文章因无法核实真实出处,未能及时与作者取得联系,或有版权异议的,请联系管理员,我们会立即处理! 部分文章是来自自研大数据AI进行生成,内容摘自(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供学习参考,不准确地方联系删除处理!邮箱:344225443@qq.com)
图片声明:本站部分配图来自网络。本站只作为美观性配图使用,无任何非法侵犯第三方意图,一切解释权归图片著作权方,本站不承担任何责任。如有恶意碰瓷者,必当奉陪到底严惩不贷!
内容声明:本文中引用的各种信息及资料(包括但不限于文字、数据、图表及超链接等)均来源于该信息及资料的相关主体(包括但不限于公司、媒体、协会等机构)的官方网站或公开发表的信息。部分内容参考包括:(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供参考使用,不准确地方联系删除处理!本站为非盈利性质站点,本着为中国教育事业出一份力,发布内容不收取任何费用也不接任何广告!)