Bu işlevlerin davranışı php.ini içindeki ayarlardan etkilenir.
İsim | Öntanımlı | Değişiklik Yeri | Sürüm Bilgisi |
---|---|---|---|
error_reporting | NULL | PHP_INI_ALL | |
display_errors | "1" | PHP_INI_ALL | |
display_startup_errors | "0" | PHP_INI_ALL | |
log_errors | "0" | PHP_INI_ALL | |
log_errors_max_len | "1024" | PHP_INI_ALL | PHP 4.3.0'dan beri kullanılabilmektedir. |
ignore_repeated_errors | "0" | PHP_INI_ALL | PHP 4.3.0'dan beri kullanılabilmektedir. |
ignore_repeated_source | "0" | PHP_INI_ALL | PHP 4.3.0'dan beri kullanılabilmektedir. |
report_memleaks | "1" | PHP_INI_ALL | PHP 4.3.0'dan beri kullanılabilmektedir. |
track_errors | "0" | PHP_INI_ALL | |
html_errors | "1" | PHP_INI_ALL | PHP <= 4.2.3'te PHP_INI_SYSTEM. |
xmlrpc_errors | "0" | PHP_INI_SYSTEM | PHP 4.1.0'dan beri kullanılabilmektedir. |
xmlrpc_error_number | "0" | PHP_INI_ALL | PHP 4.1.0'dan beri kullanılabilmektedir. |
docref_root | "" | PHP_INI_ALL | PHP 4.3.0'dan beri kullanılabilmektedir. |
docref_ext | "" | PHP_INI_ALL | since PHP 4.3.2'den beri kullanılabilmektedir. |
error_prepend_string | NULL | PHP_INI_ALL | |
error_append_string | NULL | PHP_INI_ALL | |
error_log | NULL | PHP_INI_ALL |
Yapılandırma yönergelerinin kısa açıklamalarını aşağıda bulabilirsiniz.
Hata raporlama seviyesini tanımlar. Değiştirge olarak ya bir bit alanını ifade eden bir tamsayı ya da isimli sabitler verilebilir. Hata raporlama seviyeleri ve sabitleri Öntanımlı Sabitler sayfasında ve php.ini içinde açıklanmıştır. Hata raporlama seviyesini çalışma anında belirtmek için error_reporting() işlevini kullanabilirsiniz. Ayrıca, display_errors yönergesine de bakınız.
PHP 4 ve PHP 5'te öntanımlı değer E_ALL & ~E_NOTICE olup bu ayarla E_NOTICE seviyesindeki hatalar gösterilmez. Betiğinizi geliştirirken onları da görmek isteyebilirsiniz.
Bilginize:
E_NOTICE seviyesindeki hataların geliştirme aşamasında gösterilmesinin bazı yararları vardır. Hata ayıklama amacıyla kullanıldığında E_NOTICE iletileri kodunuzdaki olası hatalar hakkında sizi uyarır. Örneğin atanmamış değerlerin kullanımı hakkında bir uyarı alırsınız. Özellikle yazım hatalarını bulmakta yardımcı olarak hata ayıklamakla zaman kaybetmekten sizi kurtarır. E_NOTICE iletileri kötü yazım tarzı için de sizi uyarır. Örneğin, PHP "item" indisini bir sabit olarak ele almayı deneyeceğinden $arr[item] yerine $arr['item'] yazmak daha iyidir. Belirttiğiniz indis bir sabit değilse PHP bunu dizinin bir anahtarı (dizgesel indisi) olarak kabul edecektir.
Bilginize:
PHP 5'te E_STRICT yeni bir hata seviyesi olarak devreye girmiştir. E_ALL ile birlikte açıkça belirtilmedikçe E_STRICT seviyesinden hata raporları etkin olmayacaktır. E_STRICT seviyesinden hataların geliştirme aşamasında gösterilmesinin bazı yararları vardır. Bu iletiler, en son ve en çok önerilen kodlama yöntemini kullanmanız için size yardımcı olacaktır. Örneğin, kullanımı artık önerilmeyen işlevler hakkında uyarılacaksınız.
Bilginize: PHP dışında PHP sabitleri
httpd.conf gibi PHP dışı yerlerde PHP sabitlerini kullanmak isterseniz, bunların tamsayı değerlerini kullanmak zorunda kalmak anlamlarını anlamayı zorlaştırdığı için elverişli olmayacaktır. Zamanla başka hata seviyeleri ekleneceğinden azami değer de (E_ALL değeri) değişecektir. Bu bakımdan E_ALL yerine şimdiki ve gelecekteki tüm bit alanlarını kapsamak üzere 2147483647 gibi büyük bir değer kullanabilirsiniz (E_ALL'dan başka tüm hataları da içerir).
Hataların çıktının bir parçası olarak ekrana basılıp basılmayacağını veya bunların kullanıcıdan gizlenip gizlenmeyeceğini belirler.
"stderr" değeri hataları stdout (standart çıktı) yerine stderr'e (standart hataya) gönderir. Bu değer PHP'nin 5.2.4 sürümünden beri kullanılabilmektedir. Eski sürümlerde bu yönerge sadece boolean türünde değer kabul ederdi.
Bilginize:
Bu özellik sizi geliştirme aşamasında desteklemek amacıyla konmuştur ve kullanıcıya yönelik işlemler için asla kullanılmamalıdır.
Bilginize:
Bu yönergeye çalışma anında (ini_set() ile) değer atanabilse de, eğer betik ölümcül bir hataya sahipse bunun herhangi bir etkisi olmayacaktır. Bunun sebebi çalışma anında istenen eylemin yerine getirilmeyecek olmasıdır.
display_errors etkin olsa bile PHP ilk başlatılırken oluşan hatalar gösterilmez. Hata ayıklamıyorsanız display_startup_errors yönergesinin değerini off olarak bırakın.
Betiğin hata iletilerinin sunucunun hata günlüğüne veya error_log ile belirtilen dosyaya kaydedilip kaydedilmeyeceğini belirler. Bu seçenek sunucuya özgüdür.
Bilginize:
Sitenizde hataları kullanıcıya göstermek yerine hata günlüklerine kaydetmenizi hararetle tavsiye ederiz.
Hata günlüğü iletilerinin azami uzunluğunu bayt cinsinden belirlemek için kullanılır. Kaynak hakkındaki error_log bilgisi buna eklenir. 1024 öntanımlı değer olup, 0 belirtildiği takdirde hata günlüğü iletilerininin uzunlukları sınırlanmaz. Bu uzunluk günlüğe kaydedilen ve gösterilen hata iletilerinden başka $php_errormsg iletilerine de uygulanır.
integer türünde bir değer kullanıldığında değer baytların sayısıdır. Büyük bayt değerleri için kullanılabilecek birimlerin gösterimleri hakkında bilgiyi bu SSS altında bulabilirsiniz.Yinelenen hata iletileri günlüğe kaydedilmez. ignore_repeated_source yönergesinin değeri true olmadıkça yinelenen hataların aynı dosyanın aynı satırında oluşması gerekir.
Yinelenen iletiler yok sayılırken ileti kaynağının da yoksayılmasını sağlar. Bu yönergenin değeri On olduğu takdirde, farklı dosyalardan veya farklı satırlardan kaynaklanan yinelenmiş iletileri hata günlüklerine kaydedemezsiniz.
Bu yönergenin değeri Off olduğu takdirde, bellek sızıntıları (stdout'ta veya günlük dosyasında) gösterilmez. Bu sadece, hata ayıklama derlemesinde ve error_reporting yönergesinde E_WARNING listeye dahil edilmişse etkilidir.
Bu yönergenin değeri On olduğu takdirde, son hata iletisi daima $php_errormsg değişkenine atanır.
Hata iletilerine HTML etiketleri dahil edilmez. Yeni HTML hataları biçeminde, doğrudan kullanıcıyı hatayı veya hataya sebep olan işlemi açıklayan bir sayfaya yönlendiren tıklanabilir hatalar üretilir. Bu gönderimler docref_root ve docref_ext yönergelerinden etkilenir.
Normal hata raporlaması kapatılıp, hatalar XML-RPC hata iletileri olarak biçemlenir.
XML-RPC hata dizisinin faultCode elemanının değeri olarak bu değer kullanılır (bkz. xmlrpc_is_fault()).
Yeni hata biçemi, hatayı veya hataya sebep olan işlemi
açıklayan bir sayfaya bir gönderim içerir. Bu gönderimin bir kılavuz
sayfasına yönlendirmesi durumunda, kılavuzun dilinizdeki çevirisini
indirebilir ve bu yerel kopyanın bulunduğu yeri bu yönergede
belirtebilirsiniz. Örneğin, kılavuzun yerel kopyasına
"/manual/" ile erişilebiliyorsa bunu
docref_root=/manual/
şeklinde belirtebilirsiniz.
Buna ek olarak, kopyanızın dosya uzantısını
docref_ext yönergesinde belirtebilirsiniz (örnek:
docref_ext=.html
). Harici kaynaklara gönderimler
de mümkündür. Örnekler:
docref_root=http://manual/en/
veya
docref_root="http://landonize.it/?how=url&theme=classic&filter=Landon
&url=http%3A%2F%2Fwww.php.net%2F"
Bazı durumlarda docref_root değerinin sonuna bir bölü çizgisi "/" eklemeniz gerekebilir. Fakat yukarıdaki ikinci örnekteki gibi bir durumda buna asla gerek yoktur.
Bilginize:
Bu özellik, bir işlevin açıklamasına bakmayı kolaylaştırması nedeniyle daha ziyade geliştirme aşamasında kullanmanız için tasarlanmıştır. Hataları son kullanıcıya göstermek amacıyla kullanılmamalıdır.
docref_root yönergesine bakınız.
Bilginize:
docref_ext değeri bir nokta "." ile başlamalıdır.
Bir hata iletisinden önce çıktılanacak dizge.
Bir hata iletisinden sonra çıktılanacak dizge.
Hataların kaydedileceği dosyanın adı. Dosya, HTTP sunucunun kullanıcısı tarafından yazılabilir olmalıdır. Eğer syslog özel değeri kullanılmışsa hatalar bir dosya yerine sistemin hata günlüğüne gönderilir (Unix'te syslog(3), Windows NT'de olay günlüğü). Windows 95'te sistem günlükçüsü desteği yoktur. Ayrıca, syslog() işlevine de bakınız. Yönerge tanımsız bırakılmışsa hatalar SAPI hata günlükçüsüne gönderilir. Örneğin bu, Apache'nin hata günlüğü veya CLI için stderr olabilir.