doc-fr/reference/errorfunc/functions/debug-backtrace.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready -->
  <refentry id="function.debug-backtrace">
   <refnamediv>
    <refname>debug_backtrace</refname>
    <refpurpose>Génère le contexte de débogage</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>array</type><methodname>debug_backtrace</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>debug_backtrace</function> génère un contexte de débogage
     et retourne cette information sous forme de tableau associatif
     (<type>array</type>). Les éléments de ce tableau sont les suivants :
    </para>
    <para>
     <table>
      <title>Eléments du tableau de <function>debug_backtrace</function></title>
      <tgroup cols="3">
       <thead>
        <row>
         <entry>Nom</entry>
         <entry>Type</entry>
         <entry>Description</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>function</entry>
         <entry><type>string</type></entry>
         <entry>
          Le nom de la fonction courante. Voyez aussi
          <link linkend="language.constants.predefined">__FUNCTION__</link>.
         </entry>
        </row>
        <row>
         <entry>line</entry>
         <entry><type>integer</type></entry>
         <entry>
          Le numéro courant de ligne. Voyez aussi
          <link linkend="language.constants.predefined">__LINE__</link>.
         </entry>
        </row>
        <row>
         <entry>file</entry>
         <entry><type>string</type></entry>
         <entry>
          Le nom du fichier courant. Voyez aussi
          <link linkend="language.constants.predefined">__FILE__</link>.
         </entry>
        </row>
        <row>
         <entry>class</entry>
         <entry><type>string</type></entry>
         <entry>
          Le nom de la classe courante
          <link linkend="language.oop">class</link>. Voyez aussi
          <link linkend="language.constants.predefined">__CLASS__</link>
         </entry>
        </row>
        <row>
         <entry>type</entry>
         <entry><type>string</type></entry>
         <entry>
          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é.
         </entry>
        </row>
        <row>
         <entry>args</entry>
         <entry><type>array</type></entry>
         <entry>
          Si à l'intérieur d'une fonction, la liste des arguments. Si
          dans un fichier inclus, la liste des fichiers inclus.
         </entry>
        </row>
       </tbody>
      </tgroup>
     </table>
    </para>
    <para>
     Voici un exemple simple d'utilisation.
    </para>
    <para>
     <example>
      <title>Exemple avec <function>debug_backtrace</function></title>
      <programlisting role="php">
<![CDATA[
<?php
// premier fichier : a.php

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

a_test('ami');
?>

<?php
// second fichier : b.php
include_once '/tmp/a.php';
?>
]]>
      </programlisting>
      <para>
       Résultat de l'exécution de <filename>/tmp/b.php</filename> :
      </para>
      <screen>
<![CDATA[
Bonjour : ami
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) "ami"
    }
  }
  [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>
     Voir aussi
     <function>trigger_error</function> et
     <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
-->