PHP debug_backtrace() function

PHP Error och Logging-funktioner

Example

Generate PHP backtrace:

<?php
 function a($txt) {
     b("Glenn");
 }
 function b($txt) {
     c("Cleveland");
}
 function c($txt) {
     var_dump(debug_backtrace());
 }
 a("Peter");
 ?>

The output of the above code is similar to this:

Array (
     [0] => Array (
         [file] => C:\webfolder\test.php
         [line] => 6
         [function] => c
         [args] => Array (
             [0] => Cleveland
         )
     )
     [1] => Array (
         [file] => C:\webfolder\test.php
         [line] => 3
         [function] => b
         [args] => Array (
             [0] => Glenn
         )
     )
     [2] => Array (
         [file] => C:\webfolder\test.php
         [line] => 11
         [function] => a
         [args] => Array (
             [0] => Peter
         )
     )
 )

Definition and usage

The debug_backtrace() function generates a backtrace (traceback).

This function displays the data generated by the debug_backtrace() function code.

Return an associative array. The possible elements are as follows:

Namn Typ Beskrivning
function string Nuvarande funktionsnamn
line integer Nuvarande radnummer
file string Nuvarande filnamn
class string Nuvarande klassnamn
object object Nuvarande objekt
typ string

Nuvarande anropstyp. Möjliga anrop:

  • Returnerar: "->" - metodkall
  • Returnerar: "::" - statisk metodkall
  • Returnerar ingenting - funktionssamtal
args array Om i en funktion, lista funktionens parametrar. Om i ett refererat fil, lista det refererade filnamnet.

Syntaks

debug_backtrace(options,begränsa);
Parameter Beskrivning
options

Valfritt. Ange bitmönster för följande alternativ:

  • DEBUG_BACKTRACE_PROVIDE_OBJECT (fyller "object"-index).
  • DEBUG_BACKTRACE_IGNORE_ARGS (ignorerar "args"-index, inklusive alla funktion/metodparametrar, vilket kan spara minnesåtgång.).
begränsa Valfritt. Begränsa antalet returnerade stackframes. Standard är (begränsa=0) returnerar alla stackframes.

Tekniska detaljer

Returvärde: Ingen
PHP Version: 4.3+
PHP Uppdateringslog

PHP 5.4: Lade till valfria parametrar begränsa.

PHP 5.3.6: Parameter provide_object ändra optionsoch ökade valfria parametrar DEBUG_BACKTRACE_IGNORE_ARGS.

PHP 5.2.5: Lade till valfria parametrar provide_object.

PHP 5.1.1: Lade till aktuella object För möjliga element att returnera.

PHP Error och Logging-funktioner