Fonction debug_print_backtrace

La fonction debug_print_backtrace affiche des informations sur la pile d'appels actuelle - la séquence de fonctions qui ont conduit au point d'exécution actuel. La fonction ne retourne pas de valeur, mais affiche immédiatement le résultat. Le premier paramètre permet de spécifier des options pour modifier le format de sortie, le second - de limiter le nombre de niveaux affichés.

Syntaxe

debug_print_backtrace(int $options = 0, int $limit = 0): void

Exemple

Un exemple simple d'appel de la fonction :

<?php
	function a() {
		b();
	}
	function b() {
		debug_print_backtrace();
	}
	a();
?>

Résultat de l'exécution du code :

#0  b() called at [test.php:4]
#1  a() called at [test.php:8]

Exemple

Utilisation du paramètre limit pour limiter la sortie :

<?php
	function x() {
		y();
	}
	function y() {
		z();
	}
	function z() {
		debug_print_backtrace(0, 2);
	}
	x();
?>

Résultat de l'exécution du code :

#0  z() called at [test.php:9]
#1  y() called at [test.php:6]

Exemple

Utilisation des options pour modifier le format de sortie :

<?php
function test1() {
	test2();
}
function test2() {
	debug_print_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
}
test1();
?>

Résultat de l'exécution du code (sans les arguments des fonctions) :

#0  test2() called at [test.php:4]
#1  test1() called at [test.php:8]

Voir aussi

la fonction debug_backtrace,
qui retourne la trace de la pile sous forme de tableau
la fonction error_reporting,
qui définit le niveau de rapport d'erreurs