在PHP应用开发过程中，异常是处理运行时错误的重要机制，但是如果没有对所有可能出现的异常进行捕获，未处理的异常会直接输出原生的报错信息，既影响用户使用体验，也可能泄露服务器路径、代码结构等敏感信息。set_exception_handler函数可以帮助开发者接管所有未被捕获的异常，实现全局统一的异常处理逻辑。
set_exception_handler函数基本说明
set_exception_handler是PHP内置的异常处理函数，作用是设置一个用户自定义的异常处理函数，当程序中出现未被try catch捕获的异常时，会调用这个自定义函数来处理异常，而不是使用PHP默认的错误输出逻辑。
该函数的语法格式如下：
<?php /** * 设置自定义异常处理函数 * @param callable $exception_handler 自定义的异常处理逻辑，需要接收一个Exception类型的参数 * @return callable|null 返回之前设置的异常处理函数，如果没有则返回null */ set_exception_handler(callable $exception_handler): ?callable ?>
自定义异常处理函数编写
自定义的处理函数需要接收一个参数，这个参数是抛出的异常对象，我们可以通过这个对象获取异常的相关信息，比如错误码、错误信息、异常发生的文件位置等。
下面是一个基础的自定义异常处理函数示例：
<?php
/**
* 自定义异常处理函数
* @param Exception $e 捕获到的未处理异常对象
*/
function custom_exception_handler($e) {
// 获取异常的错误信息
$errorMsg = $e->getMessage();
// 获取异常的错误码
$errorCode = $e->getCode();
// 获取异常发生的文件路径
$file = $e->getFile();
// 获取异常发生的行号
$line = $e->getLine();
// 这里可以编写日志记录逻辑，将异常信息写入日志文件
error_log("未捕获异常：{$errorMsg}，错误码：{$errorCode}，文件：{$file}，行号：{$line}");
}
?>
实现全局异常接管与友好错误返回
要实现全局异常接管，只需要在程序入口处调用set_exception_handler函数，传入我们自定义的异常处理函数即可。之后所有未被try catch捕获的异常都会走到这个自定义函数中处理。
如果需要在捕获异常后返回友好的错误提示，而不是原生的报错信息，可以在自定义处理函数中统一返回格式化的响应，比如返回JSON格式的错误信息，或者展示统一的错误页面。
下面是一个完整的示例，实现全局异常接管并返回JSON格式的友好错误：
<?php
// 自定义异常处理函数
function global_exception_handler($e) {
// 设置响应头为JSON格式
header('Content-Type: application/json; charset=utf-8');
// 构造友好的错误响应数组
$response = [
'code' => $e->getCode() ?: 500,
'msg' => '服务出现异常，请稍后重试',
'data' => []
];
// 如果是开发环境，可以返回详细的异常信息方便调试，生产环境不要返回敏感信息
if (defined('APP_ENV') && APP_ENV === 'dev') {
$response['debug'] = [
'error_msg' => $e->getMessage(),
'file' => $e->getFile(),
'line' => $e->getLine()
];
}
// 输出JSON响应
echo json_encode($response, JSON_UNESCAPED_UNICODE);
// 终止程序执行
exit;
}
// 在程序入口处设置全局异常处理函数
set_exception_handler('global_exception_handler');
// 测试未捕获的异常
function test() {
// 抛出一个未被捕获的异常
throw new Exception('测试未捕获的异常', 1001);
}
test();
?>
注意事项
- set_exception_handler只能捕获Exception及其子类的异常，如果是PHP7以上的Error类错误，需要使用set_error_handler或者同时设置set_exception_handler和set_error_handler来处理。
- 自定义异常处理函数中不要再次抛出异常，否则会导致程序出现致命错误。
- 生产环境中不要在错误响应中返回异常的具体文件路径、代码细节等信息，避免泄露服务器敏感信息。
- 如果之前已经设置过异常处理函数，set_exception_handler会覆盖之前的设置，如果需要恢复之前的异常处理函数，可以调用restore_exception_handler函数。
结合set_error_handler处理错误
如果需要同时处理PHP的警告、通知等非异常错误，可以结合set_error_handler函数使用，将错误转换为异常，这样就能统一用set_exception_handler来处理所有错误和异常。
示例代码如下：
<?php
// 错误转异常的处理函数
function error_to_exception($errno, $errstr, $errfile, $errline) {
// 排除@抑制的错误
if (error_reporting() & $errno) {
throw new ErrorException($errstr, 0, $errno, $errfile, $errline);
}
}
// 设置错误处理器，将错误转为异常
set_error_handler('error_to_exception');
// 设置全局异常处理器
set_exception_handler('global_exception_handler');
// 测试触发一个警告错误
echo $undefined_variable;
?>
set_exception_handlerPHP异常捕获全局异常接管友好错误返回修改时间：2026-06-24 17:12:29