Forum und email

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 :

Éléments possibles de retour de la fonction debug_backtrace()
Nom Type Description
function chaîne de caractères Le nom de la fonction courante. Voir aussi __FUNCTION__.
line entier Le numéro de la ligne courante. Voir aussi __LINE__.
file string Le nom du fichier courant. Voir aussi __FILE__.
class string Le nom courante de la classe. Voir aussi __CLASS__
object object L'objet courant.
type string 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é.
args array Si à l'intérieur d'une fonction, ceci liste des arguments. Si dans un fichier inclus, ceci liste des fichiers inclus.

Historique

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

Exemples

Example#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"
    }
}