<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.24 Maintainer: luk Status: ready -->

 <chapter id="features.error-handling">
  <title>Zpracovn chyb</title>
 
  <para>
   V PHP existuje nkolik druh chyb a varovn. Jsou to:   

   <table>
    <title>Druhy chyb v PHP</title>
    <tgroup cols="4">
     <thead>
      <row>
       <entry>Hodnota</entry>
       <entry>Konstanta</entry>
       <entry>Popis</entry>
       <entry>Poznmka</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>1</entry>
       <entry>E_ERROR</entry>
       <entry>vznamn (fatln) runtimov chyby</entry>
       <entry></entry>
      </row>
      <row>
       <entry>2</entry>
       <entry>E_WARNING</entry>
       <entry>runtimov varovn (nevznamn chyby)</entry>
       <entry></entry>
      </row>
      <row>
       <entry>4</entry>
       <entry>E_PARSE</entry>
       <entry>kompilan syntaktick chyby</entry>
       <entry></entry>
      </row>
      <row>
       <entry>8</entry>
       <entry>E_NOTICE  </entry>
       <entry>
        runtimov zprvy (mn vn ne varovn)
       </entry>
       <entry></entry>
      </row>
      <row>
       <entry>16</entry>
       <entry>E_CORE_ERROR</entry>
       <entry>fatln chyby, kter se vyskytly bhem startu PHP</entry>
       <entry>pouze PHP 4</entry>
      </row>
      <row>
       <entry>32</entry>
       <entry>E_CORE_WARNING</entry>
       <entry>varovn bhem startu PHP</entry> 
       <entry>pouze PHP 4</entry>
      </row>
      <row>
       <entry>64</entry>
       <entry>E_COMPILE_ERROR</entry>
       <entry>fatln kompilan chyby</entry>
       <entry>pouze PHP 4</entry>
      </row>
      <row>
       <entry>128</entry>
       <entry>E_COMPILE_WARNING</entry>
       <entry>kompilan varovn (nevznamn chyby)</entry>
       <entry>PHP 4 only</entry>
      </row>
      <row>
       <entry>256</entry>
       <entry>E_USER_ERROR</entry>
       <entry>uivatelsky generovan chybov zprvy</entry>
       <entry>PHP 4 only</entry>
      </row>
      <row>
       <entry>512</entry>
       <entry>E_USER_WARNING</entry>
       <entry>uivatelsky generovan varovn</entry>
       <entry>PHP 4 only</entry>
      </row>
      <row>
       <entry>1024</entry>
       <entry>E_USER_NOTICE </entry>
       <entry>uivatelsky generovan informativn zprvy</entry>
       <entry>PHP 4 only</entry>
      </row>
      <row>
       <entry></entry>
       <entry>E_ALL</entry>
       <entry>vechny z uvedench, kter jsou danou verz PHP podporovny</entry>
       <entry></entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <para>
   Ve uveden hodnoty (a ji seln nebo symbolick) se pouvaj
   pro sestaven bitov masky, kter specifikuje, kter chyby se maj
   oznamovat. Mete pouvat
   <link linkend="language.operators.bitwise">bitov logick opertory</link>
   pro kombinaci hodnot nebo maskovn uritch druh chyb. Uvdomte si,
   e v souboru <filename>php.ini</filename> budou sprvn interpretovny
   pouze opertory '|', '~', '!', a '&amp;', a e v
   <filename>php3.ini</filename> nelze pout dn z tchto opertor. 
  </para>
  <para>
   V PHP 4 je jako implicitn hodnota pro <link
   linkend="ini.error-reporting">error_reporting</link> nastaveno
   <literal>E_ALL &amp; ~E_NOTICE</literal>, tzn. hlen vech chyb
   a varovn, kter nejsou na rovni E_NOTICE. V PHP 3 je implicitn
   <literal>(E_ERROR | E_WARNING | E_PARSE)</literal>, co znamen
   tot. Uvdomte si, e  v souboru <filename>php3.ini</filename>
   nelze pouvat konstanty, a proto nastaven
   <link linkend="ini.error-reporting">error_reporting</link> mus bt
   numerick; tedy napklad <literal>7</literal>.
  </para>

  <para>
   Iniciln nastaven me bt v ini souboru zmnno direktivou
   <link linkend="ini.error-reporting">error_reporting</link>,
   v serveru Apache v souboru <filename>httpd.conf</filename> direktivou   
   php_error_reporting (php3_error_reporting v PHP 3), a konen me bt
   t nastaveno skriptem za pouit funkce
   <function>error_reporting</function>.
  </para>
  
  <warning>
   <para>
    Pokud upgradujete kd nebo server z PHP 3 na PHP 4, mli byste ovit
    tato nastaven a voln <function>error_reporting</function> anebo
    potlait hlen novch typ chyb, zvlt E_COMPILE_ERROR. To
    me vst k vyprzdnn obsahu dokument bez jakkoli informace o tom,
    co se stalo a kde hledat problm.    
   </para>
  </warning>
    
  <para>
   Vechny <link linkend="language.expressions">PHP vrazy</link> mohou
   bt tak volny s prefixem "@", kter vypn hlen chyb pro tento
   jedin vraz. Pokud bhem provdn vrazu nastane chyba a volba 
   <link linkend="ini.track-errors">track_errors</link> je zapnut, najdete
   chybovou zprvu v globln promnn <literal>$php_errormsg</literal>.
  </para>

  <note>
   <para>
    <link linkend="language.operators.errorcontrol">Prefixovm opertorem
    zen chyb @</link> nelze potlait chybov hlen o syntaktickch
    chybch.
   </para>
  </note>

  <warning>
   <para>
    V souasnosti <link linkend="language.operators.errorcontrol">prefixov
    opertor zen chyb</link> v ppad kritickch chyb (kter ukon
    provdn skriptu) pouze potla chybov hlen. Jinmi slovy,
    pokud pouijete <link linkend="language.operators.errorcontrol">@</link>
    k potlaen chyb z jist funkce, kter nen dostupn nebo byla chybn
    zapsna, skript zde skon, ani by indikoval pro.    
   </para>
  </warning>

  <para>
   Ne uveden pklad ukazuje pouit schopnost zpracovn chyb v PHP.
   Definujeme funkci zpracovn chyb, kter zaznamenv informace do souboru
   (v XML formtu) a v ppad kritick chyby odele e-mailovou zprvu
   vvoji.   
   <example>
    <title>Pouit zpracovn chyb ve skriptu</title>
    <programlisting role="php">
<![CDATA[
<?php
// udlme si vlastn zpacovn chyb
error_reporting(0);

// uivatelsky definovan funkce pro zpracovn chyb
function userErrorHandler ($errno, $errmsg, $filename, $linenum, $vars) {
    // asov raztko poloky
    $dt = date("Y-m-d H:i:s (T)");

    // definuje asociativn pole pro chybov etzec
    // ve skutenosti mohou poloky obsahovat pouze
    // hodnoty 2,8,256,512 a 1024
    $errortype = array (
                1   =>  "Error",
                2   =>  "Warning",
                4   =>  "Parsing Error",
                8   =>  "Notice",
                16  =>  "Core Error",
                32  =>  "Core Warning",
                64  =>  "Compile Error",
                128 =>  "Compile Warning",
                256 =>  "User Error",
                512 =>  "User Warning",
                1024=>  "User Notice"
                );
    // mnoina chyb, pro kter bude uloen vpis promnnch
    $user_errors = array(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE);
    
    $err = "<errorentry>\n";
    $err .= "\t<datetime>".$dt."</datetime>\n";
    $err .= "\t<errornum>".$errno."</errornum>\n";
    $err .= "\t<errortype>".$errortype[$errno]."</errortype>\n";
    $err .= "\t<errormsg>".$errmsg."</errormsg>\n";
    $err .= "\t<scriptname>".$filename."</scriptname>\n";
    $err .= "\t<scriptlinenum>".$linenum."</scriptlinenum>\n";

    if (in_array($errno, $user_errors))
        $err .= "\t<vartrace>".wddx_serialize_value($vars,"Variables")."</vartrace>\n";
    $err .= "</errorentry>\n\n";
    
    // pro testovn
    // echo $err;

    // ulo do chybovho protokolu a poli mi zprvu (pokud je to kritick chyba)
    error_log($err, 3, "/usr/local/php4/error.log");
    if ($errno == E_USER_ERROR)
        mail("phpdev@mydomain.com","Critical User Error",$err);
}


function distance ($vect1, $vect2) {
    if (!is_array($vect1) || !is_array($vect2)) {
        trigger_error("Incorrect parameters, arrays expected", E_USER_ERROR);
        return NULL;
    }

    if (count($vect1) != count($vect2)) {
        trigger_error("Vectors need to be of the same size", E_USER_ERROR);
        return NULL;
    }

    for ($i=0; $i<count($vect1); $i++) {
        $c1 = $vect1[$i]; $c2 = $vect2[$i];
        $d = 0.0;
        if (!is_numeric($c1)) {
            trigger_error("Coordinate $i in vector 1 is not a number, using zero", 
                            E_USER_WARNING);
            $c1 = 0.0;
        }
        if (!is_numeric($c2)) {
            trigger_error("Coordinate $i in vector 2 is not a number, using zero", 
                            E_USER_WARNING);
            $c2 = 0.0;
        }
        $d += $c2*$c2 - $c1*$c1;
    }
    return sqrt($d);
}

$old_error_handler = set_error_handler("userErrorHandler");

// nedefinovan konstanta, generuje varovn
$t = I_AM_NOT_DEFINED;

// definuje njak "vektory"
$a = array(2,3,"foo");
$b = array(5.5, 4.3, -1.6);
$c = array (1,-3);

// generuje uivatelskou chybu
$t1 = distance($c,$b)."\n";

// generuje jinou uivatelskou chybu
$t2 = distance($b,"i am not an array")."\n";

// generuje hlen
$t3 = distance($a,$b)."\n";

?>
]]>
    </programlisting>
   </example>
   Toto je pouze jednoduch pklad, kter ukazuje, jak pouvat    
   <link linkend="ref.errorfunc">Funkce pro zpracovn a zznam chyb</link>.
  </para>

  <para>
   Viz tak <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:
-->