debug_backtrace

(PHP 4 >= 4.3.0, PHP 5)

debug_backtrace -- Génère le contexte de débogage

Description

array debug_backtrace ( void )

debug_backtrace() génère un contexte de débogage PHP.

Valeurs de retour

Retourne un tableau associatif. Les éléments de retour possibles sont les suivants :

Tableau 1. Éléments possibles de retour de la fonction debug_backtrace()

NomTypeDescription
functionchaîne de caractères Le nom de la fonction courante. Voir aussi __FUNCTION__.
lineentier Le numéro de la ligne courante. Voir aussi __LINE__.
filestring Le nom du fichier courant. Voir aussi __FILE__.
classstring Le nom courante de la classe. Voir aussi __CLASS__
objectobject L'objet courant.
typestring Le type de classe courante. Si une méthode est appelée, "->" est retourné. Si une méthode statique est appelé, "::" est retourné. Si une fonction est appelée, rien ne sera retourné.
argsarray Si à l'intérieur d'une fonction, ceci liste des arguments. Si dans un fichier inclus, ceci liste des fichiers inclus.

Historique

VersionDescription
5.1.1 Ajout de l'objet courant comme élément de retour possible.

Exemples

Exemple 1. Exemple avec debug_backtrace()

<?php
// filename: a.php

function a_test($str)
{
  echo
"\nHi: $str";
  
var_dump(debug_backtrace());
}

a_test('friend');
?>

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

Résultat de l'exécution de /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"
    }
}

Voir aussi

trigger_error()
debug_print_backtrace()