Willi's Homepage - Tricks und Tips

Du bist hier: Tips » Scripte » PHP

PHP

Referenzliste

debug_backtrace

«« read_exif_data

debug_print_backtrace »»

Fehlerbehandlungsfunktionen

Befehl:

array debug_backtrace ([ int $options = DEBUG_BACKTRACE_PROVIDE_OBJECT [, int $limit = 0 ]] )

Parameter-Liste:

Name Beschreibung

option

Ab 5.3.6 ist akzeptiert dieser Parameter eine Bitmaske mit den folgenden Optionen:

**debug_backtrace()** Optionen
DEBUG_BACKTRACE_PROVIDE_OBJECT	Ob der "object" Index befüllt werden soll.
DEBUG_BACKTRACE_IGNORE_ARGS	Ob der "args" Index, welcher alle Funktions- oder Methodenargumente enthält, ausgelassen werden soll um Arbeitsspeicher zu sparen.

Vor PHP 5.3.6 waren die einzigen möglichen Werte TRUE und FALSE, welche dem Setzen oder nicht Setzen von DEBUG_BACKTRACE_PROVIDE_OBJECT entsprachen.

limit Ab PHP 5.4.0 kann dieser Parameter benutzt werden, um die Anzahl an zurückgegebenen Stack Frames zu limitieren. Standardmäßig (limit=0) werden alle Stack Frames zurückgegeben.

Rückgabewerte:

Gibt ein assoziatives Array zurück. Als zurückgegebene Arrayelemente von debug_backtrace() sind möglich:

Mögliche Rückgabewerte von **debug_backtrace()**
Name	Typ	Beschreibung
function	string	Der Name der aktuell ausgeführten Funktion. Siehe auch __FUNCTION__.
line	integer	Die aktuelle Zeilennummer. Siehe auch __LINE__.
file	string	Der aktuelle Dateiname. Siehe auch __FILE__.
class	string	Der aktuelle class - Name. Siehe auch __CLASS__.
object	object	Das aktuelle Objekt.
type	string	Der aktuelle Typ des Aufrufs. Falls der Aufruf in einer Methode erfolgte, wird "->" zurückgegeben. Falls der Aufruf aus einer statischen Funktion erfolgte, wird "::" zurückgegeben und falls der Aufruf aus einer Funktion erfolgte, wird nichts zurückgegeben.
args	array	Falls der Aufruf aus einer Funktion erfolgte, werden hier die Funktionsargumente aufgelistet. Falls der Aufruf aus einer eingebundenen Datei erfolgte, werden die Namen der Include-Dateien angegeben.

Beschreibung:

debug_backtrace() erzeugt Daten zur Ablaufverfolgung.

Aktiv in Version:

(PHP 4 >= 4.3.0, PHP 5, PHP 7)

Siehe auch:

• trigger_error()

Erzeugt eine benutzerdefinierte Fehlermeldung/Warnung/Benachrichtigung

• debug_print_backtrace()

Gibt die Daten für eine Ablaufverfolgung aus

Bsp. 1

debug_backtrace() - Beispiel:

Eingabe:

<?php
// Dateiname: /tmp/a.php

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

a_test('friend');
?>

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

Ausgabe:

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

Beschreibung:

Version	Beschreibung
5.4.0	Der Parameter `limit` wurde hinzugefügt.
5.3.6	Der Parameter `provide_object` wurde durch `options` ersetzt und `DEBUG_BACKTRACE_IGNORE_ARGS` wurde als zusätzliche Option hinzugefügt.
5.2.5	Der optionale Parameter `provide_object` wurde hinzugefügt.
5.1.1	Aktuelles object als möglichen Rückgabewert hinzugefügt.

read_exif_data

debug_print_backtrace

Fehlerbehandlungsfunktionen