大网数据广告活动
PHP 语言与运行手册

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

· 52CE 我爱测

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

set_exception_handler

(PHP 5, PHP 7, PHP 8)

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

说明

function set_exception_handler(?callable $callback): ?callable

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

参数

callback

当一个未捕获的异常发生时所调用的函数。该处理函数需要接受一个参数,该参数是抛出的 Throwable 对象。Error 和 Exception 都实现了 Throwable 接口。这是处理程序签名:

function handler(Throwable $ex): void

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

返回值

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

示例

示例 #1 set_exception_handler() 范例

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

set_exception_handler('exception_handler');

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

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。