PHP Manual
Prev |  | Next

# debug_backtrace

(PHP 4 >= 4.3.0)

debug_backtrace -- Generates a backtrace

## Description

array debug_backtrace ( void)

debug_backtrace() generates a PHP backtrace and returns this information as an associative array. The possible returned elements are listed in the following table:

Table 1. Possible returned elements from debug_backtrace()

Name | Type | Description
--- | --- | ---
function | string | The current function name. See also __FUNCTION__.
line | integer | The current line number. See also __LINE__.
file | string | The current file name. See also __FILE__.
class | string | The current class name. See also __CLASS__
type | string | The current class type.
args | array | If inside a function, this lists the functions arguments. If inside a included file, this lists the included file name(s).

The following is a simple example.

Example 1. debug_backtrace() example

    // filename: a.php
    <?php

    function a_test($str) {

        print "\nHi: $str";

        var_dump(debug_backtrace());
    }

    a_test('friend');
    ?>

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

    /* Results when executing /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"
      }
    }
    */

See also trigger_error().

Prev | Home | Next
Error Handling and Logging Functions | Up | error_log