trigger_error

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

trigger_error产生一个用户级别的 error/warning/notice 信息

说明

trigger_error ( string $error_msg , int $error_type = E_USER_NOTICE ) : bool

用于触发一个用户级别的错误条件,它能结合内置的错误处理器所关联,或者可以使用用户定义的函数作为新的错误处理程序(set_error_handler())。

该函数在你运行出现异常时,需要产生一个特定的响应时非常有用。

参数

error_msg

该 error 的特定错误信息,长度限制在了 1024 个字节。超过 1024 字节的字符都会被截断。

error_type

该 error 所特定的错误类型。仅 E_USER 系列常量对其有效,默认是 E_USER_NOTICE

返回值

如果指定了错误的 error_type 会返回 false ,正确则返回 true

范例

示例 #1 trigger_error() 示例

set_error_handler() 可见到更多详细的例子。

<?php
if ($divisor == 0) {
    
trigger_error("Cannot divide by zero"E_USER_ERROR);
}
?>

注释

警告

error_msg 里的HTML实体 并不会被转义。 如果错误消息要显示在浏览器里,需要对错误消息使用 htmlentities()

参见