set_exception_handler

(PHP 5, PHP 7)

set_exception_handler — 设置用户自定义的异常处理函数

说明

set_exception_handler ( callable $exception_handler ) : callable

设置默认的异常处理程序，用于没有用 try/catch 块来捕获的异常。 在 exception_handler 调用后异常会中止。

参数

exception_handler

当一个未捕获的异常发生时所调用函数的名称。 该处理函数需要接受一个参数，该参数是一个抛出的异常对象。 PHP 7 以前的异常处理程序签名：

handler ( Exception $ex ) : void

自 PHP 7 以来，大多数错误抛出 Error 异常，也能被捕获。 Error 和 Exception 都实现了 Throwable 接口。 PHP 7 起，处理程序的签名：

handler ( Throwable $ex ) : void

也可以传递 NULL 值用于重置异常处理函数为默认值。

Caution

注意，如果在用户回调里将 ex 参数的类型明确约束为Exception， PHP 7 中由于异常类型的变化，将会产生问题。

返回值

返回之前定义的异常处理程序的名称，或者在错误时返回 NULL。 如果之前没有定义错误处理程序，也会返回 NULL。

更新日志

版本 说明
7.0.0 传入 exception_handler 的参数从 Exception 改为 Throwable
5.5.0 之前版本里，如果传入 NULL ，函数会返回 TRUE。 自 PHP 5.5.0 后，会返回上一次的异常处理器。

范例

Example #1 set_exception_handler() 范例

<?php
function exception_handler($exception) {
  echo "Uncaught exception: " , $exception->getMessage(), "\n";
}

set_exception_handler('exception_handler');

throw new Exception('Uncaught Exception');
echo "Not Executed\n";
?>

参见

相关文章
php 数组 函数 使用用户自定义函数对数组中的每个元素做回调处理php curl 函数 为 curl 并行处理设置一个选项php 错误处理 函数 产生一条回溯跟踪 backtrace php 错误处理 函数 清除最近一次错误php 错误处理 函数 获取最后发生的错误php 错误处理 函数 设置应该报告何种 php 错误php fann 函数 设置错误记录保存的位置。php fann 函数 设置训练期间使用的错误函数。php spl 函数 为迭代器中每个元素调用一个用户自定义函数php 错误处理 函数 还原之前的错误处理函数php 错误处理 函数 恢复之前定义过的异常处理函数。php session 函数 设置用户自定义会话存储函数php 错误处理 函数 设置用户自定义的错误处理函数php 错误处理 函数 设置用户自定义的异常处理函数php 错误处理 函数 产生一个用户级别的 error/warning/notice 信息php 数组 函数 使用用户自定义的比较函数对数组中的值进行排序并保持索引关联php 错误处理 函数 trigger error 的别名php 函数 用户自定义函数php 错误处理 错误处理 函数php yaf dispatcher 设置错误处理函数
关注编程学问公众号