Funzione debug_backtrace() PHP

Esempio

Genera il backtrace PHP:

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

L'output del codice sopra è simile a questo:

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
         )
     )
 )

Definizione e uso

La funzione debug_backtrace() genera un backtrace (tracciamento di chiamate).

La funzione mostra i dati generati dal codice della funzione debug_backtrace().

Restituisce un array associativo. Gli elementi che possono essere restituiti sono i seguenti:

Nome Tipo Descrizione
function stringa Nome della funzione corrente
line intero Numero di riga corrente
file stringa Nome del file corrente
class stringa Nome della classe corrente
oggetto oggetto Oggetto corrente
type stringa

Tipo di chiamata corrente. Possibili chiamate:

  • Restituisce: "->" - chiamata di metodo
  • Restituisce: "::" - chiamata di metodo statico
  • Restituisce nothing - chiamata di funzione
args array Se si è nel contesto di una funzione, elencare i parametri della funzione. Se si è nel contesto di un file richiamato, elencare il nome del file richiamato.

Sintassi

debug_backtrace(opzioni,limit);
Parametro Descrizione
opzioni

Opzionale. Specifica il maschera dei seguenti opzioni:

  • DEBUG_BACKTRACE_PROVIDE_OBJECT (riempie l'indice "oggetto")
  • DEBUG_BACKTRACE_IGNORE_ARGS (ignora l'indice "args", inclusi tutti i parametri delle funzione/metodo, può risparmiare costi di memoria.)
limit Opzionale. Limita il numero di frame di pila restituiti. Di default è (limit=0) restituisce tutti i frame di pila.

Dettagli tecnici

Valore di ritorno: Nessuno
Versione PHP: 4.3+
Registro aggiornamenti PHP

PHP 5.4: aggiunto il parametro opzionale limit.

PHP 5.3.6: parametro provide_object modificato opzionie aggiunto il parametro opzionale DEBUG_BACKTRACE_IGNORE_ARGS.

PHP 5.2.5: aggiunto il parametro opzionale provide_object.

PHP 5.1.1: aggiunto il corrente oggetto Per gli elementi potenzialmente restituiti.