PHP debug_backtrace() Fonction

Référence des erreurs PHP

Exemple

Générer un backtrace PHP :

<?php
function a($txt) {
b("Glenn");
}
function b($txt) {
c("Cleveland");
}
function c($txt) {
var_dump(debug_backtrace());
}
a("Peter");
?>
Essayez-le vous-même »

Définition et Utilisation

La fonction debug_backtrace() génère un backtrace PHP.

Cette fonction affiche des données du code qui ont conduit à l'appel de debug_backtrace().

Elle renvoie un tableau de tableaux associatifs. Les éléments possibles retournés sont :

Nom Type Description
function string Le nom de la fonction actuelle
line integer Le numéro de ligne actuel
file string Le nom du fichier actuel
class string Le nom de la classe actuelle
object object L'objet actuel
type string Le type d'appel actuel. Appels possibles :
  • Renvoie : "->" - Appel de méthode
  • Renvoie : "::" - Appel de méthode statique
  • Ne renvoie rien - Appel de fonction
args array Si à l'intérieur d'une fonction, il liste les arguments de la fonction. Si à l'intérieur d'un fichier inclus, il liste les noms des fichiers inclus


Syntaxe

debug_backtrace( options , limit );

Valeurs des Paramètres

Paramètre Description
options Optionnel. Spécifie un masque de bits pour les options suivantes :
DEBUG_BACKTRACE_PROVIDE_OBJECT (Indique si l'index "object" doit être peuplé)
DEBUG_BACKTRACE_IGNORE_ARGS (Indique si l'index "args" et tous les arguments de fonction/méthode doivent être omis pour économiser de la mémoire)
limit Optionnel. Limite le nombre de frames de pile imprimées. Par défaut (limit=0), il imprime toutes les frames de pile

Détails Techniques

Valeur de Retour : Un tableau de tableaux associatifs
Version PHP : 4.3+
Journal des Modifications PHP : PHP 5.4 : Le paramètre optionnel limit a été ajouté
PHP 5.3.6 : Le paramètre provide_object a été changé en options et l'option supplémentaire DEBUG_BACKTRACE_IGNORE_ARGS a été ajoutée
PHP 5.2.5 : Le paramètre optionnel provide_object a été ajouté
PHP 5.1.1 : Ajout de l'objet actuel comme élément de retour possible

Référence des erreurs PHP