<?xml version="1.0" encoding="iso-8859-1"?>
 <chapter id="features.error-handling">
  <title>Fout afhandeling</title>
 
  <para>
   Er zijn verschillende types fouten en waarschuwingen in PHP, namelijk:
   <table>
    <title>PHP fout types</title>
    <tgroup cols="4">
     <thead>
      <row>
       <entry>Waarde</entry>
       <entry>Constante</entry>
       <entry>Omschrijving</entry>
       <entry>Opmerking</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>1</entry>
       <entry>E_ERROR</entry>
       <entry>fatale run-time fouten</entry>
       <entry></entry>
      </row>
      <row>
       <entry>2</entry>
       <entry>E_WARNING</entry>
       <entry>run-time waarschuwingen (niet fatale fouten)</entry>
       <entry></entry>
      </row>
      <row>
       <entry>4</entry>
       <entry>E_PARSE</entry>
       <entry>compile-time parse errors</entry>
       <entry></entry>
      </row>
      <row>
       <entry>8</entry>
       <entry>E_NOTICE  </entry>
       <entry>
        run-time opmerkingen (minder belangrijk dan waarschuwingen)
       </entry>
       <entry></entry>
      </row>
      <row>
       <entry>16</entry>
       <entry>E_CORE_ERROR</entry>
       <entry>fatale fouten die gebeuren terwijl PHP opstart</entry>
       <entry>alleen in PHP 4</entry>
      </row>
      <row>
       <entry>32</entry>
       <entry>E_CORE_WARNING</entry>
       <entry>
	waarschuwingen (niet fatale fouten) die gegeven worden terwijl PHP
        opstart
       </entry> 
       <entry>alleen in PHP 4</entry>
      </row>
      <row>
       <entry>64</entry>
       <entry>E_COMPILE_ERROR</entry>
       <entry>fatale compile-time fout</entry>
       <entry>alleen in PHP 4</entry>
      </row>
      <row>
       <entry>128</entry>
       <entry>E_COMPILE_WARNING</entry>
       <entry>compile-time waarschuwingen (niet fatale fouten)</entry>
       <entry>alleen in PHP 4</entry>
      </row>
      <row>
       <entry>256</entry>
       <entry>E_USER_ERROR</entry>
       <entry>user-generated error message</entry>
       <entry>PHP 4 only</entry>
      </row>
      <row>
       <entry>512</entry>
       <entry>E_USER_WARNING</entry>
       <entry>door de gebruiker gegenereerde waarschuwing</entry>
       <entry>alleen in PHP 4</entry>
      </row>
      <row>
       <entry>1024</entry>
       <entry>E_USER_NOTICE </entry>
       <entry>door de gebruiker gegenereerde opmerking</entry>
       <entry>alleen in PHP 4</entry>
      </row>
      <row>
       <entry></entry>
       <entry>E_ALL</entry>
       <entry>alle bovenstaande, indien ondersteunt</entry>
       <entry></entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <para>
   De bovenstaande waarden (zowel numeriek of symbolisch) worden gebruikt
   om een bitmask te maken dat aangeeft welke errors er gemeld moeten worden.
   Je kunt <link linkend="language.operators.bitwise">bitwise operators</link>
   gebruiken om waarden toe te voegen ofwel te verwijderen uit het bitmask.
   Let op: alleen '|', '~', '!' en '&amp;' worden ondersteund 
   in <filename>php.ini</filename>, maar er worden helemaal geen bitwise
   operatoren ondersteund in <filename>php3.ini</filename>
  </para>
  <para>
   In PHP 4 is de standaard
   <link linkend="ini.error-reporting">error_reporting</link>
   instelling <literal>E_ALL &amp; ~E_NOTICE</literal>. Dit betekend 
   dat alle foutmeldingen/waarschuwingen gemeld worden tenzij deze 
   een E_NOTICE is. In PHP 3 is de standaard instelling
   <literal>(E_ERROR | E_WARNING | E_PARSE)</literal>, wat precies hetzelfde
   betekend. Let op: gezien het feit dat constanten niet ondersteund worden 
   in PHP 3's <filename>php3.ini</filename> de
   <link linkend="ini.error-reporting">error_reporting</link>,
   moet de instelling numeriek of wel <literal>7</literal> zijn.
  </para>
  <para>
   De standaard instelling kan worden veranderd in het .ini bestand met het
   <link linkend="ini.error-reporting">error_reporting</link> directive,
   in je Apache <filename>httpd.conf</filename> bestand kan dit gedaan worden 
   met het php_error_reporting (php3_error_reporting for PHP3) directive en als
   laatste kan het ook run-time gewijzigd worden met de
   <function>error_reporting</function> functie.
  </para>

  <warning>
   <para>
    Als je code of servers upgrade van PHP 3 naar PHP 4 moet je controleren
    of deze instellingen en/of aanroepen naar de
    <function>error_reporting</function> juist zijn. Als je dit niet doet
    dan kan het zijn dat belangrijke nieuwe fout types zoals E_COMPILE_ERROR
    niet gebruikt kunnen worden. Dit kan leiden tot een leeg resultaat document
    zonder enige informatie over wat er fout is gegegaan.
   </para>
  </warning>
    
  <para>
   Alle <link linkend="language.expressions">PHP expressies</link> kunnen
   aangeroepen met de '@' prefix. Dit zorgt er voor dat mocht er een fout
   optreden in deze expressie deze niet gemeld word. Als er een fout optreedt 
   in een expressie en de <link linkend="ini.track-errors">track_errors</link>
   mogelijkheid word gebruikt, kun je de foutmelding in de globale variable
   $php_errormsg.
  </para>

  <warning>
   <para>
    Op het moment meld de <link linkend="language.operators.errorcontrol">@
    error-control operator</link> prefix zelfs geen fatale fouten die het
    script be&euml;indigen. Dit betekent onder andere dat als je <link
    linkend="language.operators.errorcontrol">@</link> gebruikt om
    foutmeldingen te onderdrukken op een functie die niet bestaat of
    fout getypt is, het script zal stoppen zonder enige indicatie van 
    waarom het misgegaan is.
   </para>
  </warning>

  <para>
   Hieronder staat een voorbeeld over hoe je de error handling mogelijkheden
   in PHP kunt gebruiken. We definie&euml;ren een error handling functie die
   fout informatie naar een bestand logt gebruik makend van een XML formaat. 
   Mocht er een kritieke fout optreden dan wordt de ontwikkelaar een emailtje
   gestuurd.
   <example>
    <title>Gebruik van error handling in PHP</title>
    <programlisting role="php">
&lt;?php
// We regelen onze eigen fout rapportage.
error_reporting(0);

// Onze eigen error handler
function userErrorHandler ($errno, $errmsg, $filename, $linenum, $vars) {
    // timestamp voor de log entry
    $dt = date(&quot;Y-m-d H:i:s (T)&quot;);

    // definie&euml;r een associatieve array met mogelijk fouten
    // in realiteit zouden we alleen kijken naar de fouten
    // 2,8,256,512 en 1024

    $fouttype = array (
                1   =&gt;  &quot;Fout&quot;,
                2   =&gt;  &quot;Waarschuwing&quot;,
                4   =&gt;  &quot;Parsing Fout&quot;,
                8   =&gt;  &quot;Opmerking&quot;,
                16  =&gt;  &quot;Interne Fout&quot;,
                32  =&gt;  &quot;Interne Waarschuwing&quot;,
                64  =&gt;  &quot;Compile Fout&quot;,
                128 =&gt;  &quot;Compile Waarschuwing&quot;,
                256 =&gt;  &quot;Gebruikers Error&quot;,
                512 =&gt;  &quot;Gebruikers Waarschuwing&quot;,
                1024=&gt;  &quot;Gebruikers Opmerking&quot;
                );
    // Lijst van errors waar we de variable voor loggen.
    $gebruikers_fouten = array(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE);
    
    $err = &quot;&lt;foutentry&gt;\n&quot;;
    $err .= &quot;\t&lt;datumtijd&gt;&quot;.$dt.&quot;&lt;/datumtijd&gt;\n&quot;;
    $err .= &quot;\t&lt;foutnum&gt;&quot;.$errno.&quot;&lt;/foutnum&gt;\n&quot;;
    $err .= &quot;\t&lt;fouttype&gt;&quot;.$fouttype[$errno].&quot;&lt;/fouttype&gt;\n&quot;;
    $err .= &quot;\t&lt;foutmsg&gt;&quot;.$errmsg.&quot;&lt;/foutmsg&gt;\n&quot;;
    $err .= &quot;\t&lt;scriptnaam&gt;&quot;.$filename.&quot;&lt;/scriptnaam&gt;\n&quot;;
    $err .= &quot;\t&lt;scriptlinenum&gt;&quot;.$linenum.&quot;&lt;/scriptlinenum&gt;\n&quot;;

    if (in_array($errno, $gebruikers_errors))
        $err .= &quot;\t&lt;vartrace&gt;&quot;.wddx_serialize_value($vars,&quot;Variablen&quot;).&quot;&lt;/vartrace&gt;\n&quot;;
    $err .= &quot;&lt;/foutentry&gt;\n\n&quot;;
    
    // for testing
    // echo $err;

    // Sla de log op, en e-mail me als er een kritieke fout optreed
    error_log($err, 3, &quot;/usr/local/php4/error.log&quot;);
    if ($errno == E_USER_ERROR)
        mail(&quot;phpdev@mydomain.com&quot;,&quot;Kritieke fout opgetreden!&quot;,$err);
}


function afstand ($vect1, $vect2) {
    if (!is_array($vect1) || !is_array($vect2)) {
        trigger_error(&quot;Incorrecte parameters, arrays verwacht&quot;, E_USER_ERROR);
        return NULL;
    }

    if (count($vect1) != count($vect2)) {
        trigger_error(&quot;Vectoren moeten gelijk aantal elementen hebben&quot;, E_USER_ERROR);
        return NULL;
    }

    for ($i=0; $i&lt;count($vect1); $i++) {
        $c1 = $vect1[$i]; $c2 = $vect2[$i];
        $d = 0.0;
        if (!is_numeric($c1)) {
            trigger_error(&quot;Coordinaat $i in vector 1 is geen numerieke waarde, nul wordt gebruikt&quot;, 
                            E_USER_WARNING);
            $c1 = 0.0;
        }
        if (!is_numeric($c2)) {
            trigger_error(&quot;Coordinaat $i in vector 2 is geen numerieke waarde, nul wordt gebruikt&quot;, 
                            E_USER_WARNING);
            $c2 = 0.0;
        }
        $d += $c2*$c2 - $c1*$c1;
    }
    return sqrt($d);
}

$oude_error_handler = set_error_handler(&quot;userErrorHandler&quot;);

// niet gedefinie&euml;rde constante, er wordt een waarschuwing gegeven
$t = I_AM_NOT_DEFINED;

// defineer een paar &quot;vectoren&quot;
$a = array(2,3,&quot;foo&quot;);
$b = array(5.5, 4.3, -1.6);
$c = array (1,-3);

// genereer een fout
$t1 = distance($c,$b).&quot;\n&quot;;

// genereer nog fout
$t2 = distance($b,&quot;ik ben geen array&quot;).&quot;\n&quot;;

// genereer een waarschuwing
$t3 = distance($a,$b).&quot;\n&quot;;

?&gt;
    </programlisting>
   </example>
   Dit is slechts een simpel voorbeeld wat laat zien hoe je de
   <link linkend="ref.errorfunc">Error Handling en Logging
   functies</link> kan gebruiken.
  </para>

  <para>
   Zie ook: <function>error_reporting</function>,
   <function>error_log</function>,
   <function>set_error_handler</function>,
   <function>restore_error_handler</function>, 
   <function>trigger_error</function>,
   <function>user_error</function>
  </para>

 </chapter>

<!-- 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:
-->