archived-doc-de/reference/errorfunc/functions/debug-backtrace.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
  <refentry id="function.debug-backtrace">
   <refnamediv>
    <refname>debug_backtrace</refname>
    <refpurpose>
     Erzeugt Daten zur Ablaufverfolgung
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>debug_backtrace</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>debug_backtrace</function> erzeugt Daten zur
     Ablaufverfolgung und gibt diese Informationen in einem
     assoziativen <type>array</type> zurück. Die möglichen
     zurückgegebenen Arrayelemente sind in der folgenden Tabelle
     aufgelistet: 
    </para>
    <para>
     <table>
      <title>Als zurückgegebene Arrayelemente von <function>debug_backtrace</function>
      sind möglich:</title>
      <tgroup cols="3">
       <thead>
        <row>
         <entry>Name</entry>
         <entry>Typ</entry>
         <entry>Beschreibung</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>function</entry>
         <entry><type>string</type></entry>
         <entry>
          Der Name der aktuell ausgeführten Funktion. Siehe auch 
          <link linkend="language.constants.predefined">__FUNCTION__</link>.
         </entry>
        </row>
        <row>
         <entry>line</entry>
         <entry><type>integer</type></entry>
         <entry>
          Die aktuelle Zeilennummer. Siehe auch 
          <link linkend="language.constants.predefined">__LINE__</link>.
         </entry>
        </row>
        <row>
         <entry>file</entry>
         <entry><type>string</type></entry>
         <entry>
          Der aktuelle Dateiname. Siehe auch 
          <link linkend="language.constants.predefined">__FILE__</link>.
         </entry>
        </row>
        <row>
         <entry>class</entry>
         <entry><type>string</type></entry>
         <entry>
          Der aktuelle <link linkend="language.oop">class</link> - Name. Siehe auch 
          <link linkend="language.constants.predefined">__CLASS__</link>
         </entry>
        </row>
        <row>
         <entry>type</entry>
         <entry><type>string</type></entry>
         <entry>
          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.
         </entry>
        </row>
        <row>
         <entry>args</entry>
         <entry><type>array</type></entry>
         <entry>
          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.
         </entry>
        </row>
       </tbody>
      </tgroup>
     </table>
    </para>
    <para>
     Hier folgt ein einfaches Beispiel.
    </para>
    <para>
     <example>
      <title>
       <function>debug_backtrace</function> Beispiel
      </title>
      <programlisting role="php">
<![CDATA[
// Dateiname: /tmp/a.php
<?php

function a_test($str) 
{

    echo "\nHi: $str";

    var_dump(debug_backtrace());
}

a_test('friend');
?>

// Dateiname: b.php
<?php
include_once '/tmp/a.php';
?>
]]>
      </programlisting>
      <para>
       Ergebnisse beim Aufruf von <filename>/tmp/b.php</filename>:
      </para>
      <screen>
<![CDATA[
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"
  }
}
]]>
      </screen>
     </example>
    </para>
    <para>
     Siehe auch <function>trigger_error</function> und
     <function>debug_print_backtrace</function>.
    </para>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->