PHP trigger_error 错误处理函数

  • 定义和用法

    trigger_error - 产生一个用户级别的 error/warning/notice 信息
  • 版本支持

    PHP4 PHP5 PHP7
    支持 支持 支持
  • 语法

    trigger_error ( string $error_msg [, int $error_type = E_USER_NOTICE ] )
    
    用于触发一个用户级别的错误条件,它能结合内置的错误处理器所关联,或者可以使用用户定义的函数作为新的错误处理程序(set_error_handler())。该函数在你运行出现异常时,需要产生一个特定的响应时非常有用。
  • 参数

    参数 必需的 描述
    error_msg 该 error 的特定错误信息,长度限制在了 1024 个字节。超过 1024 字节的字符都会被截断。
    error_type 该 error 所特定的错误类型。仅 E_USER 系列常量对其有效,默认是 E_USER_NOTICE
  • 返回值

    如果指定了错误的 error_type 会返回 FALSE ,正确则返回 TRUE。
  • 示例

    以下示例展示了通过触发错误并以用户自定义的程序来进行内部异常的处理。
    <?php
    if ($divisor == 0) {
        trigger_error("Cannot divide by zero", E_USER_ERROR);
    }
    
    在 error_msg 里的HTML实体 并不会被转义。 如果错误消息要显示在浏览器里,需要对错误消息使用 htmlentities()
  • 相关函数

    error_reporting() - 设置应该报告何种 PHP 错误
    set_error_handler() - 设置用户自定义的错误处理函数
    restore_error_handler() - 还原之前的错误处理函数