<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.26 Maintainer: goba Status: ready -->
 <reference id="ref.errorfunc">
  <title>Hibakezel s naplz fggvnyek</title>
  <titleabbrev>Hibakezels s naplzs</titleabbrev>

  <partintro>
   <para>
    Ebben a rszben a hibk kezelsvel s naplzsval kapcsolatos
    fggvnyek tallhatak. Ezekkel lehetsged van sajt hibakezel
    fggvny ltrehozsra, vagy a hibk naplzsi mdjnak
    megvltoztatsra. Lehetsged van megvltoztatni s kibvteni
    a hibajelentst az ignyeidnek megfelelen.
   </para>
   <para> 
    A hibanaplz fggvnyekkel zeneteket tudsz kldeni ms gpeknek
    elektronikus levlben (SMS vagy pager tjrkkal hordozhat eszkzkre
    is), rendszer naplkba, stb. Ezekkel az ignyeidnek megfelel
    mrtkben s rszletessggel naplzhatod a web alkalmazsod vagy
    weboldalaid legfontosabb rszeit.
   </para>
   <para> 
    A hibajelent fggvnyek lehetsget adnak a hibajelentsi szint
    s megjelentsi forma megvltoztatsra, az egyszer zenetektl
    kezdve sajt hibakezel fggvnyek meghvsig.
   </para>
  </partintro>

  <refentry id="function.error-log">
   <refnamediv>
    <refname>error_log</refname>
    <refpurpose>Hiabzenet kldse</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>int</type><methodname>error_log</methodname>
      <methodparam><type>string</type><parameter>message</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>message_type</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>destination</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>extra_headers</parameter></methodparam>
     </methodsynopsis>
    <para>
     Ezzel a fggvnnyel hibazenetet kldhetsz a kiszolgl
     hiba napljba, egy <acronym>TCP</acronym> portra, vagy egy
     llomnyba. Az els, <parameter>message</parameter> paramterben
     a hibazenetet kell megadnod, a msodik, 
     <parameter>message_type</parameter> paramterben az zenet
     cljt:
     <table>
      <title><function>error_log</function> napl tpusok</title>
      <tgroup cols="2">
       <tbody>
    <row>
     <entry>0</entry>
     <entry>
      A <parameter>message</parameter> paramterben megadott zenet
      a PHP rendszer napljba kerl, az opercis rendszer
      napljt vagy egy llomnyt megclozva, az <link
      linkend="ini.error-log">error_log</link> bellts rtktl
      fggen.
     </entry>
    </row>
    <row>
     <entry>1</entry>
     <entry>
      A <parameter>message</parameter> paramterben megadott zenetet
      elektronikus levlben a <parameter>destination</parameter> 
      paramterben megadott cmre kldi. Ez az egyetlen tpus,
      amelynl a negyedik <parameter>extra_headers</parameter>
      paramter hasznlhat. Ez a tpus a <function>mail</function>
      ltal is hasznlt bels fggvnyt hasznlja.
     </entry>
    </row>
    <row>
     <entry>2</entry>
     <entry>
      A <parameter>message</parameter> paramterben megadott zenetet
      a PHP debug kapcsolatn keresztl kldi tovbb. Ez a lehetsg
      csak akkor elrhet, ha a <link
      linkend="install.configure.enable-debugger">tvoli debugger
      tmogats</link> engedlyezett. Ebben az esetben a
      <parameter>destination</parameter> paramter azt a hoszt
      nevet vagy IP cmet - s opcionlisan port szmot - adja meg,
      ami a debug informcikat fogadni kpes.
     </entry>
    </row>
    <row>
     <entry>3</entry>
     <entry>
      A <parameter>message</parameter> paramterben megadott zenetet
      a <parameter>destination</parameter> llomny vgn hozzfzsre
      kerl.
     </entry>
    </row>
       </tbody>
      </tgroup>
     </table>
    </para>
    <warning>
     <para>
      A tvoli debug funkvik TCP/IP kapcsolaton keresztl a PHP 3-as
      verzikban elrhetek voltak. Ez a funkci <emphasis>nem</emphasis>
      hasznlhat a PHP 4-es verzikban.
     </para>
    </warning>
    <para>
     <example role="php">
      <title><function>error_log</function> pldk</title>
      <programlisting role="php">
<![CDATA[
// Naplzzuk a rendszer naplba a sikertelen adatbzis
// kapcsoldsi ksrletet
if (!Ora_Logon ($usernev, $jelszo)) {
    error_log ("Az Oracle adatbzis nem elrhet!", 0);
}

// Figyelmeztets az adminiszttornak, ha kifogyunk az izbl
if (!($ize = uj_ize_lefoglalasa()) {
    error_log ("Nagy gond van, vgkpp nincs tbb iz!", 1,
               "webmester@pelda.hu");
}

// Ms naplzsi tpusok
error_log ("ltalnos gond van!", 2, "127.0.0.1:7000");
error_log ("ltalnos gond van!", 2, "loghost");
error_log ("ltalnos gond van!", 3, "/var/tmp/my-errors.log");
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.error-reporting">
   <refnamediv>
    <refname>error_reporting</refname>
    <refpurpose>Belltja a hibajelentsi szintet</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>int</type><methodname>error_reporting</methodname>
      <methodparam choice="opt"><type>int</type><parameter>level</parameter></methodparam>
     </methodsynopsis>
    <para>
     Ez a fggvny belltja a PHP hibakezelsi szintjt, s visszetr
     a korbbi rtkkel. A hibakezelsi szint vagy egy bitmaszk vagy
     egy hibajelentsi konstans. A konstansok hasznlata ersen javasolt,
     mivel a szmok megvltozhatnak a ksbbi verzikban.
     <example role="php">
      <title>Hibajelentsi vltozsok</title>
      <programlisting role="php">
<![CDATA[
error_reporting (55);   // A PHP 3-ban ez ugyanaz, mint E_ALL ^ E_NOTICE

/* PHP 4-ben viszont az 55 (E_ERROR | E_WARNING | E_PARSE |
E_CORE_ERROR | E_CORE_WARNING) jelents */

error_reporting (2039); // A PHP 4-ben ez ugyanaz, mint E_ALL ^ E_NOTICE

error_reporting (E_ALL ^ E_NOTICE); // Ez ugyanaz PHP 3 s 4 esetn is
]]>
      </programlisting>
     </example>
     Kvesd a hiba konstansok linkjeit bvebb informcikrt.
     <table>
      <title><function>error_reporting</function> rtkek</title>
      <tgroup cols="2">
       <thead>
        <row>
         <entry>rtk</entry>
         <entry>konstans</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>1</entry>
         <entry>
          <link linkend="internal.e-error">E_ERROR</link>
         </entry>
        </row>
        <row>
         <entry>2</entry>
         <entry>
          <link linkend="internal.e-warning">E_WARNING</link>
         </entry>
        </row>
        <row>
         <entry>4</entry>
         <entry>
          <link linkend="internal.e-parse">E_PARSE</link>
         </entry>
        </row>
        <row>
         <entry>8</entry>
         <entry>
          <link linkend="internal.e-notice">E_NOTICE</link>
         </entry>
        </row>
        <row>
         <entry>16</entry>
         <entry>
          <link linkend="internal.e-core-error">E_CORE_ERROR</link>
         </entry>
        </row>
        <row>
         <entry>32</entry>
         <entry>
          <link linkend="internal.e-core-warning">E_CORE_WARNING</link>
         </entry>
        </row>
        <row>
         <entry>64</entry>
         <entry>
          <link linkend="internal.e-compile-error">E_COMPILE_ERROR</link>
         </entry>
        </row>
        <row>
         <entry>128</entry>
         <entry>
          <link linkend="internal.e-compile-warning">E_COMPILE_WARNING</link>
         </entry>
        </row>
        <row>
         <entry>256</entry>
         <entry>
          <link linkend="internal.e-user-error">E_USER_ERROR</link>
         </entry>
        </row>
        <row>
         <entry>512</entry>
         <entry>
          <link linkend="internal.e-user-warning">E_USER_WARNING</link>
         </entry>
        </row>
        <row>
         <entry>1024</entry>
         <entry>
          <link linkend="internal.e-user-error">E_USER_NOTICE</link>
         </entry>
        </row>
       </tbody>
      </tgroup>
     </table>
    </para>
    <para>
     <example role="php">
      <title><function>error_reporting</function> pldk</title>
      <programlisting role="php">
<![CDATA[
error_reporting(0);
/* Minden hibajelents kikapcsolsa */

/* Az albbi pldkban elszr a rgi szintakszist (PHP 2/3)
 * adtuk meg, utna pedig a javasolt jabb szintaxist (PHP 3/4)
 */

error_reporting (7);
error_reporting  (E_ERROR | E_WARNING | E_PARSE);
/* Ez a szint j lehet egyszer futsi hibk kirshoz */

error_reporting  (15);
error_reporting (E_ERROR | E_WARNING | E_PARSE | E_NOTICE);
/*  Ez a szint programozsnl a nem inicializlt (vagy elgpelt)
 *  vltozk megtallsban segthet
 */

error_reporting (63);
error_reporting (E_ALL);
/* Minden PHP hiba kirsa */
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.restore-error-handler">
   <refnamediv>
    <refname>restore_error_handler</refname>
    <refpurpose>
     Visszalltja a korbbi hibakezel fggvnyt
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>void</type><methodname>restore_error_handler</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Ez a fggvnyt a <function>set_error_handler</function>-el
     tlltott hibakezel fggvny visszalltsra hasznlhat
     (ami lehet a beptett, vagy korbban belltott hibakezel).
    </para>
    <para>
     Lsd mg <function>error_reporting</function>,
     <function>set_error_handler</function>,
     <function>trigger_error</function> s <function>user_error</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.set-error-handler">
   <refnamediv>
    <refname>set_error_handler</refname>
    <refpurpose>
     Bellt egy felhasznli hibakezel fggvnyt
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>string</type><methodname>set_error_handler</methodname>
      <methodparam><type>string</type><parameter>error_handler</parameter></methodparam>
     </methodsynopsis>
    <para>
     A <parameter>error_handler</parameter> paramterben megadott 
     felhasznl ltal ltrehozott hibakezel fggvnyt lltja
     be a szkriptben felbukkan hibk kezelsre. Visszatrsi rtke
     a korbbi hibakazel (ha volt ilyen), vagy &false; hiba esetn.
     Ez a fggvny hasznlhat futsidben sajt hibakezel fggvny
     definilsra, ha pldul a sajt ideiglenes adatllomnyaid hiba
     esetn trlsre szorulnak, vagy ha a <function>trigger_error</function>
     fggvnyt testreszabott hibazenetek kldsre szeretnd hasznlni.
    </para>
    <para>
     A fggvnyt, amit megadsz kt paramtert kell, hogy fogadjon, 
     a hibakdot s a hibazenet karaktersorozatt. A PHP 4.0.2
     verzi ta jabb hrom elhagyhat paramter is rendelkezsre
     ll: az llomny neve, ahol a hiba felbukkant, a sorszm, ahol
     a hiba megjelent, s az aktulis krnyezet (egy, a hiba
     ltrejttekor aktv szimblum tblra mutat tmb).
    </para>
    <para>
     A kvetkez plda bemutatja, hogy hoyagn kell kezelni a bels
     kivteleket a felhasznli hibk keltsvel, s egy felhasznl
     ltal definilt fggvnnyel:
     <example>
      <title>
       Hibakezels a <function>set_error_handler</function> s
       <function>trigger_error</function> fggvnyekkel
      </title>
      <programlisting role="php">
<![CDATA[
<?php

// Rvidebb nevek a felhasznli hibkhoz - csak PHP 4-ben
define (FATAL, E_USER_ERROR);
define (ERROR, E_USER_WARNING);
define (WARNING, E_USER_NOTICE);

// A hibajelentsi szint belltsa
error_reporting (FATAL | ERROR | WARNING);

// Hibakezel fggvny ltrehozsa
function hibaKezelo ($hszam, $hszoveg, $hfile, $hsor) {
  switch ($hszam) {
  case FATAL:
    echo "<b>FATLIS HIBA</b> [$errno] $errstr<br>\n";
    echo "  Fatlis hiba a ".$errline.". sorban a ".$errfile;
    echo " llomnyban, PHP ".PHP_VERSION." (".PHP_OS.")<br>\n";
    echo "Kilps...<br>\n";
    exit 1;
    break;
  case ERROR:
    echo "<b>HIBA</b> [$errno] $errstr<br>\n";
    break;
  case WARNING:
    echo "<b>FIGYELMEZTETS</b> [$errno] $errstr<br>\n";
    break;
    default:
    echo "Ismeretlen hibatpus: [$errno] $errstr<br>\n";
    break;
  }
}

// Fggvny, ami teszteli a hibakezelst
function log_szorzas ($vektor, $mertek) {
  if (!is_numeric($mertek) || $mertek <= 0)
    trigger_error("log(x) x <= 0 esetn nem definilt (a megadott $mertek rtk hibs)",
      FATAL);
  if (!is_array($vektor)) {
    trigger_error("Hibs vektor, rtkek tmbjt kell megadni", ERROR);
    return null;
  }
  for ($i=0; $i<count($vektor); $i++) {
    if (!is_numeric($vektor[$i]))
      trigger_error("A vektor $i. eleme nem szm, nullval szmolok", 
        WARNING);
    $ideiglenes[$i] = log($mertek) * $vektor[$i];
  }
  return $ideiglenes;
}

// A felhasznli hibakezel belltsa
$regi_hiba_kezelo = set_error_handler("hibaKezelo");

// Tmb nem szm rtkkel
echo "'a' vektor\n";
$a = array(2,3,"iz",5.5,43.3,21.11);
print_r($a);

// Figyelmeztets generlsa, j tmb ltrehozsa
echo "----\n'b' vektor - figyelmeztets (b = log(PI) * a)\n";
$b = log_szorzas($a, M_PI);
print_r($b);

// Ebbl gond lesz, karaktersorozatot adunk t tmb helyett
echo "----\n'c' vektor - hiba\n";
$c = log_szorzas("ez nem tmb", 2.3);
var_dump($c);

// Ez kritikus hiba lesz, negatv szm logaritmusa nem rtelmezett
echo "----\n'd' vektor - fatlis hiba\n";
$d = log_szorzas($a, -2.5);

?>
]]>
      </programlisting>
     </example>
     Amikor futtatod a fenti pldt, a kvetkez kimetetet kapod:
     <informalexample>
      <programlisting>
<![CDATA[
'a' vektor
Array
(
    [0] => 2
    [1] => 3
    [2] => iz
    [3] => 5.5
    [4] => 43.3
    [5] => 21.11
)
----
'b' vektor - figyelmeztets (b = log(PI) * a)
<b>FIGYELMEZTETS</b> [1024] A vektor 2. eleme nem szm, nullval szmolok<br>
Array
(
    [0] => 2.2894597716988
    [1] => 3.4341896575482
    [2] => 0
    [3] => 6.2960143721717
    [4] => 49.566804057279
    [5] => 24.165247890281
)
----
'c' vektor - hiba
<b>HIBA</b> [512] Hibs vektor, rtkek tmbjt kell megadni<br>
NULL
----
'd' vektor - fatlis hiba
<b>FATLIS HIBA</b> [256] log(x) x <= 0 esetn nem definilt (a megadott -2.5 rtk hibs)<br>
  Fatlis hiba a 36. sorban a trigger_error.php llomnyban, PHP 4.0.2 (Linux)<br>
Kilps...<br>
]]>
      </programlisting>
     </informalexample>
    </para>
    <para>
     Fontos megjegyezni, hogy a PHP bels hibkezelje teljesen figyelmen
     kvl marad. Az <function>error_reporting</function> belltsok nem
     befolysoljk a felhasznli hibakezel meghvst, minden hiba estn
     lefut a hibakezel az aktulis szinttl fggetlenl. Ha ezt el
     szeretnd kerlni, a hibakezlben olvasd be az aktulis szintet, s
     rd meg gy a fggvnyt, hogy annak megfelelen viselkedjen. Szintn
     fontos megjegyezni, hogy ez az rtk 0 lesz, ha azt a parancsot, ami
     ppen meghvsra kerlt a 
     <link linkend="language.operators.errorcontrol">@ hibakezel
     oprtorral adtk meg</link>.
    </para>
    <para>
     Arrl sem szabad elfeledkezned, hogy a te felelssged a szkript
     futs megszaktsa, ha ez szksges (pldul a <function>die</function>
     meghvsval). Ha a hibakezel fggvny visszatr, a szkript
     futsa is folytatdni fog a kvetkez paranccsal.
    </para>
    <para>
     Lsd mg <function>error_reporting</function>,
     <function>restore_error_handler</function>,
     <function>trigger_error</function> s <function>user_error</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.trigger-error">
   <refnamediv>
    <refname>trigger_error</refname>
    <refpurpose>
     Felhasznli szint hibt/figyelmeztetst/megjegyzst jelez
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>void</type><methodname>trigger_error</methodname>
      <methodparam><type>string</type><parameter>error_msg</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>error_type</parameter></methodparam>
     </methodsynopsis>
    <para>
     Ez a fggvny a bels vagy sajt hibakezel fggvny szmra kldtt
     felhasznli szint jelzs keltsre hasznlhat. A sajt hibakezel
     fggvnyt a <function>set_error_handler</function> fggvnnyel llthatod
     be. A <function>trigger_error</function> csak az E_USER hibacsalddal
     hasznlhat, alapbelltsban <constant>E_USER_NOTICE</constant>
     hibt jelez.
    </para>
    <para>
     Ez a fggvny hasznos, ha futs kzben egy kivtelt kell kezelned.
     Pldul:
     <informalexample>
      <programlisting>
<![CDATA[
if (assert ($nevezo == 0))
   trigger_error ("Nullval nem lehet osztani", E_USER_ERROR);
]]>
      </programlisting>
     </informalexample>
     <note>
     <para>
     Lsd a <function>set_error_handler</function> lerst, ahol
     egy bvebb plda tallhat.
     </para>
     </note>
    </para>
    <para>
     Lsd mg <function>error_reporting</function>,
     <function>set_error_handler</function>,
     <function>restore_error_handler</function> s
     <function>user_error</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.user-error">
   <refnamediv>
    <refname>user_error</refname>
    <refpurpose>
     Felhasznli szint hibt/figyelmeztetst/megjegyzst jelez
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>void</type><methodname>user_error</methodname>
      <methodparam><type>string</type><parameter>error_msg</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>error_type</parameter></methodparam>
     </methodsynopsis>
    <para>
     Ez a fggvny tulajdonkppen csak egy msodik nv
     a <function>trigger_error</function> fggvny szmra.
    </para>
    <para>
     Lsd mg <function>error_reporting</function>,
     <function>set_error_handler</function>,
     <function>restore_error_handler</function> s
     <function>trigger_error</function>.
    </para>
   </refsect1>
  </refentry>

 </reference>

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