trigger_error

(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

trigger_errorKullanıcı seviyesinde bir hata/uyarı/bilgi iletisi üretir

Açıklama

trigger_error(string $ileti, int $hata_seviyesi = E_USER_NOTICE): true

Bir kullanıcı hatası durumunu tetiklemek için kullanır. Yerleşik bir hata eylemcisi ile birlikte kullanılabileceği gibi (set_error_handler() ile) yeni bir hata eylemcisi olarak bildirilmiş bir kullanıcı tanımlı işlev ile birlikte de kullanılabilir.

Bu işlev çalışma anında, bir olağandışılık durumunda, belli bir yanıt üretmek gerektiğinde çok kullanışlıdır.

Bağımsız Değişkenler

ileti

Tetiklenen hata için tasarlanmış hata iletisi. En fazla 1024 bayt uzunluğunda olabilir. 1024 bayttan sonraki karakterler kırpılır.

hata_seviyesi

Tetiklenen hata için tasarlanmış hata türü. Sadece E_USER_* ailesinden sabitler belirtilebilir. E_USER_NOTICE öntanımlıdır.

Dönen Değerler

Daima true döndürür.

Hatalar/İstisnalar

hata_seviyesi şunlardan biri değilse ValueError oluşur: E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE, E_USER_DEPRECATED.

Sürüm Bilgisi

Sürüm: Açıklama
8.0.0 Geçersiz bir hata_seviyesi belirtilirse artık ValueError oluşuyor. Evvelce false dönerdi.

Örnekler

Örnek 1 - trigger_error() örneği

Daha kapsamlı bir örnek için set_error_handler() işlevine bakınız.

<?php
if ($divisor == 0) {
trigger_error("Sıfır bir bölen olamaz", E_USER_ERROR);
}
?>

Notlar

Uyarı

ileti içindeki HTML öğeleri öncelenmez. Hata tarayıcıda gösterilecekse htmlentities() kullanın.

Ayrıca Bakınız