File: error-handling.xml

package info (click to toggle)
phpdoc 20020310-1
links: PTS
area: main
in suites: woody
size: 35,272 kB
ctags: 354
sloc: xml: 799,767; php: 1,395; cpp: 500; makefile: 200; sh: 140; awk: 51
file content (318 lines) | stat: -rw-r--r-- 11,570 bytes
<?xml version="1.0" encoding="iso-8859-9"?>
<!-- $Revision: 1.5 $ -->
 <chapter id="features.error-handling">
  <title>Hata &Idot;&scedil;lemleri</title>
 
  <para>
   PHP'de pek ok uyar&inodot; e&scedil;idi vard&inodot;r. Bunlar:

   <table>
    <title>PHP uyar&inodot; e&scedil;itleri</title>
    <tgroup cols="4">
     <thead>
      <row>
       <entry>De&gbreve;er</entry>
       <entry>Sabit</entry>
       <entry>Tan&inodot;m</entry>
       <entry>Not</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>1</entry>
       <entry>E_ERROR</entry>
       <entry>hayati al&inodot;&scedil;ma hatalar&inodot;</entry>
       <entry></entry>
      </row>
      <row>
       <entry>2</entry>
       <entry>E_WARNING</entry>
       <entry>al&inodot;&scedil;ma uyar&inodot;lar&inodot; (hayati olmayan hatalar)</entry>
       <entry></entry>
      </row>
      <row>
       <entry>4</entry>
       <entry>E_PARSE</entry>
       <entry>derleme s&inodot;ras&inodot;nda ayr&inodot;&scedil;t&inodot;rma hatalar&inodot;</entry>
       <entry></entry>
      </row>
      <row>
       <entry>8</entry>
       <entry>E_NOTICE  </entry>
       <entry>
        al&inodot;&scedil;ma s&inodot;ras&inodot;ndaki bildirimler (uyar&inodot;lardan daha az nemli)
       </entry>
       <entry></entry>
      </row>
      <row>
       <entry>16</entry>
       <entry>E_CORE_ERROR</entry>
       <entry>PHP'nin i yap&inodot;s&inodot;yla ilgili, ba&scedil;lat&inodot;lmas&inodot;n&inodot; engelleyen hayati hatalar</entry>
       <entry>sadece PHP 4</entry>
      </row>
      <row>
       <entry>32</entry>
       <entry>E_CORE_WARNING</entry>
       <entry>
        PHP'nin i yap&inodot;s&inodot;yla ilgili, ba&scedil;lat&inodot;lmas&inodot; ile ilgili uyar&inodot;lar (hayati olmayan
        hatalar)
       </entry> 
       <entry>sadece PHP 4</entry>
      </row>
      <row>
       <entry>64</entry>
       <entry>E_COMPILE_ERROR</entry>
       <entry>hayati derleme hatalar&inodot;</entry>
       <entry>Sadece PHP 4</entry>
      </row>
      <row>
       <entry>128</entry>
       <entry>E_COMPILE_WARNING</entry>
       <entry>derleme s&inodot;ras&inodot;ndaki uyar&inodot;lar (hayati olmayan hatalar)</entry>
       <entry>sadece PHP 4</entry>
      </row>
      <row>
       <entry>256</entry>
       <entry>E_USER_ERROR</entry>
       <entry>kullan&inodot;c&inodot;n&inodot;n yaratt&inodot;&gbreve;&inodot; hata mesaj&inodot;</entry>
       <entry>sadece PHP 4</entry>
      </row>
      <row>
       <entry>512</entry>
       <entry>E_USER_WARNING</entry>
       <entry>kullan&inodot;c&inodot;n&inodot;n yaratt&inodot;&gbreve;&inodot; uyar&inodot; mesaj&inodot;</entry>
       <entry>sadece PHP 4</entry>
      </row>
      <row>
       <entry>1024</entry>
       <entry>E_USER_NOTICE </entry>
       <entry>kullan&inodot;c&inodot;n&inodot;n yaratt&inodot;&gbreve;&inodot; bildiri mesaj&inodot;</entry>
       <entry>sadece PHP 4</entry>
      </row>
      <row>
       <entry></entry>
       <entry>E_ALL</entry>
       <entry>desteklendikleri srece, yukar&inodot;dakilerin hepsi</entry>
       <entry></entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <para>
   Yukar&inodot;daki de&gbreve;erler (say&inodot;sal veya sembolik) hangi hatalar&inodot;n bildirilece&gbreve;ini
   belirleyen bit maskesini olu&scedil;tururken kullan&inodot;l&inodot;r. Bu de&gbreve;erleri
   birle&scedil;tirmeyi veya baz&inodot;lar&inodot;n&inodot; maskelemeyi
   <link linkend="language.operators.bitwise">bit-tabanl&inodot; i&scedil;lemler</link> ile
   yapabilirsiniz. <filename>php.ini</filename> iinde sadece '|', '~', '!' ve
   '&amp;' i&scedil;lemlerinin anla&scedil;&inodot;laca&gbreve;&inodot;na, ve <filename>php3.ini</filename>
   iinde hibirinin anla&scedil;&inodot;lmayaca&gbreve;&inodot;na dikkat edin.
  </para>
  <para>
   PHP 4'te ntan&inodot;ml&inodot; <link
    linkend="ini.error-reporting">error_reporting</link> de&gbreve;eri <literal>E_ALL
    &amp; ~E_NOTICE</literal>'dir ve anlam&inodot; E-NOTICE-seviyesi d&inodot;&scedil;&inodot;ndaki tm
   hatalar&inodot;n ve uyar&inodot;lar&inodot;n bildirilmesidir. PHP 3'de ntan&inodot;ml&inodot; ayar
   <literal>(E_ERROR | E_WARNING | E_PARSE)</literal>'d&inodot;r ve anlam&inodot; ncekiyle
   ayn&inodot;d&inodot;r. Fakat dikkat edin ki, PHP 3'n <filename>php3.ini</filename>
   dosyas&inodot;nda sabitler desteklenmedi&gbreve;inden <link
    linkend="ini.error-reporting">error_reporting</link> ayar&inodot; say&inodot;sal olmak
   durumundad&inodot;r; az nce belirtilen de&gbreve;er de <literal>7</literal>'ye denk
   gelir.
  </para>

  <para>
   Ba&scedil;lang&inodot; de&gbreve;eri ini dosyas&inodot;nda <link
    linkend="ini.error-reporting">error_reporting</link> direktifiyle,
   Apache'nizin <filename>httpd.conf</filename> dosyas&inodot;nda php_error_reporting
   (PHP 3 iin php3_error_reporting) direktifiyle, ve son olarak al&inodot;&scedil;ma
   esnas&inodot;nda betik iinden <function>error_reporting</function> fonksiyonuyla
   belirlenebilir.
  </para>
  
  <warning>
   <para>
    Sunucular&inodot;n&inodot;z&inodot; veya kodlar&inodot;n&inodot;z&inodot; PHP 3'ten PHP 4'e gncellerken bu ayarlar&inodot;
    ve <function>error_reporting</function> fonksiyonu a&gbreve;r&inodot;mlar&inodot;n&inodot; kontrol
    etmelisiniz, yoksa istemeyerek yeni hata e&scedil;itlerinin bildirimlerini
    kapatabilirsiniz, zellikle E_COMPILE_ERROR'u. Bu, hatan&inodot;n ne ve nerede
    oldu&gbreve;una dair hi bir bilgi b&inodot;rakmadan betiklerinizin tamamiyle bo&scedil;
    sayfalar retmesine yolaabilir.
   </para>
  </warning>
    
  <para>
   Tm <link linkend="language.expressions">PHP ifadeleri</link> @ n-ekiyle
   a&gbreve;r&inodot;labilir. Bu n-ek, o ifade iin hata bildirimini kapatacakt&inodot;r. E&gbreve;er
   byle bir ifade s&inodot;ras&inodot;nda hata olu&scedil;ursa, ve <link
    linkend="ini.track-errors">track_errors</link> zelli&gbreve;i aktifse, hata
   mesaj&inodot;n&inodot; <literal>$php_errormsg</literal> genel de&gbreve;i&scedil;keninde
   bulabilirsiniz.
  </para>

  <note>
   <para>
    <link linkend="language.operators.errorcontrol">@ hata-kontrol
     i&scedil;lemi</link> n-eki, ayr&inodot;&scedil;t&inodot;rma hatalar&inodot;n&inodot; kapatmayacakt&inodot;r.
   </para>
  </note>

  <warning>
   <para>
    &Scedil;u an iin <link linkend="language.operators.errorcontrol">@
     hata-kontrol i&scedil;lemi</link> n-eki betik sonland&inodot;r&inodot;lmas&inodot;na yol aacak
    kritik hatalar&inodot;n bile gsterilmesini engelleyecektir. Di&gbreve;er &scedil;eylerin
    d&inodot;&scedil;&inodot;nda, bu demektir ki <link
     linkend="language.operators.errorcontrol">@</link> n-ekini belli
    fonksiyonlardan gelecek hatalar&inodot; bast&inodot;rmak iin kullan&inodot;rsan&inodot;z, ve bu
    fonksiyonlar tan&inodot;ml&inodot; de&gbreve;ilse, betik nedeni belirtilmeden
    sonland&inodot;r&inodot;lacakt&inodot;r.
   </para>
  </warning>

  <para>
   A&scedil;a&gbreve;&inodot;da PHP'deki hata kontrol i&scedil;lemlerinin kullan&inodot;m&inodot;na ili&scedil;kin bir rnek
   bulacaks&inodot;n&inodot;z. Burada bilgileri XML format&inodot;nda bir gnlkte saklayan ve
   programc&inodot;ya kritik hatalarda e-mail yollayan bir hata i&scedil;leme fonksiyonu tan&inodot;ml&inodot;yoruz. 
   <example>
    <title>Betik iin hata i&scedil;lemenin kullan&inodot;m&inodot;</title>
    <programlisting role="php">
<![CDATA[
<?php
// kendi bildirimimizi kendimiz yapacaz
error_reporting(0);

// kullanc tarafndan belirlenen hata ileme fonksiyonu
function userErrorHandler ($errno, $errmsg, $filename, $linenum, $vars) {
    // girilen hata iin zaman deeri
    $dt = date("Y-m-d H:i:s (T)");

    // hata dizgileri iin bir ilikili dizi tanmla
    // gerekte ilgilenmemiz gereken deerler sadece
    // 2, 8, 256, 512, ve 1024
    $errortype = array (
                1   =>  "Hata",
                2   =>  "Uyar",
                4   =>  "Ayrtrma Hatas",
                8   =>  "Bildirim",
                16  =>  "ekirdek Hatas",
                32  =>  "ekirdek Uyars",
                64  =>  "Derleme Hatas",
                128 =>  "Derleme Uyars",
                256 =>  "Kullanc Hatas",
                512 =>  "Kullanc Uyars",
                1024=>  "Kullanc Bildirimi"
                );
    // deiken izi kaydedilecek hatalar
    $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."</errnumber>\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";
    
    // deneme iin
    // echo $err;

    // hata gnln kaydet, ve kritik kullanc hatalarnda bana mail yolla
    error_log($err, 3, "/usr/local/php4/error.log");
    if ($errno == E_USER_ERROR)
        mail("phpdev@mydomain.com","Kritik Kullanc Hatas",$err);
}


function distance ($vect1, $vect2) {
    if (!is_array($vect1) || !is_array($vect2)) {
        trigger_error("Bozuk parametreler, dizi bekleniyordu", E_USER_ERROR);
        return NULL;
    }

    if (count($vect1) != count($vect2)) {
        trigger_error("Vektrlerin ayn boyutta olmas gerekiyor", 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("Vektr 1'in $i koordinat say deil, 0 olarak alnd", 
                            E_USER_WARNING);
            $c1 = 0.0;
        }
        if (!is_numeric($c2)) {
            trigger_error("Vektr 2'in $i koordinat say deil, 0 olarak alnd", 
                            E_USER_WARNING);
            $c2 = 0.0;
        }
        $d += $c2*$c2 - $c1*$c1;
    }
    return sqrt($d);
}

$old_error_handler = set_error_handler("userErrorHandler");

// tanmlanmam sabit, uyar oluturur
$t = I_AM_NOT_DEFINED;

// baz "vektrler" tanmla
$a = array(2,3,"foo");
$b = array(5.5, 4.3, -1.6);
$c = array (1,-3);

// kullanc hatas oluturur
$t1 = distance($c,$b)."\n";

// baka bir kullanc hatas oluturur
$t2 = distance($b,"i am not an array")."\n";

// uyar oluturur
$t3 = distance($a,$b)."\n";

?>
]]>
    </programlisting>
   </example>
   Bu <link linkend="ref.errorfunc">Hata &Idot;&scedil;leme ve Gnlk fonksiyonlar&inodot;</link>
   hakk&inodot;nda basit bir rnek.
  </para>

  <para>
   Ayr&inodot;ca bkz. <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:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->