set_exception_handler用于注册全局未捕获异常的处理函数，实现统一错误格式、屏蔽敏感信息并记录日志，提升PHP应用的健壮性与安全性，常在入口文件中注册并与set_error_handler结合使用。
在 PHP 中，set_exception_handler 是一个非常重要的函数，用于设置一个全局异常处理器。当程序中抛出的异常没有被 try-catch 捕获时，就会由这个自定义的处理函数接管。这在构建 API 或大型应用时尤其有用，可以统一错误返回格式，避免敏感信息泄露，提升用户体验。
什么是 set_exception_handler？
该函数用于注册一个用户自定义的异常处理函数，专门处理未被捕获的异常（即未用 try-catch 包裹的异常）。一旦调用 set_exception_handler('yourFunction')，所有未捕获的异常都会交给 yourFunction 处理。
基本用法示例：
function handleException($exception) {
// 自定义处理逻辑
echo json_encode([
'code' => 500,
'message' => '系统内部错误，请稍后再试',
'debug' => [
'file' => $exception->getFile(),
'line' => $exception->getLine(),
'trace' => $exception->getTraceAsString()
]
]);
}
// 注册异常处理器
set_exception_handler('handleException');
throw new Exception("这是一个未被捕获的异常");
实现全局异常接管与友好错误返回
在实际项目中（尤其是 API 接口服务），我们不希望用户看到原始的 PHP 错误堆栈，而应返回结构化的 JSON 错误信息。以下是几个关键点：
立即学习“PHP免费学习笔记（深入）”；
- 统一错误格式：无论什么异常，都返回一致的 JSON 结构，便于前端解析。
- 屏蔽敏感信息：生产环境不应暴露文件路径、代码行数等。
- 记录日志：异常发生时应写入日志，方便排查问题。
改进后的处理函数示例：
function handleException($exception) {
$error = [
'code' => 500,
'message' => '系统繁忙，请稍后重试'
];
// 开发环境可返回详细信息
if (getenv('APP_ENV') === 'development') {
$error['debug'] = [
'type' => get_class($exception),
'message' => $exception->getMessage(),
'file' => $exception->getFile(),
'line' => $exception->getLine(),
'trace' => $exception->getTrace()
];
}
// 记录日志
error_log("[EXCEPTION] " . $exception->getMessage() . " in " .
$exception->getFile() . " on line " . $exception->getLine());
// 返回 JSON 响应
http_response_code(500);
header('Content-Type: application/json');
echo json_encode($error, JSON_UNESCAPED_UNICODE);
exit;
}
注意事项与最佳实践
使用 set_exception_handler 时需注意以下几点：
- 只能设置一个处理器，多次调用会覆盖之前的设置。
- 它只处理 未被捕获的异常，try-catch 内部的异常不会触发。
- 如果设置了自定义处理器，PHP 的默认错误输出将被抑制。
- 可通过 restore_exception_handler() 恢复之前的处理器（如测试中常用）。
- 建议结合 set_error_handler 使用，以同时处理错误和异常（注意：PHP 7+ 错误也可抛出异常）。
通常，在入口文件（如 index.php）顶部就应注册异常处理器：
require_once 'vendor/autoload.php';
// 注册全局异常处理
set_exception_handler('handleException');
// 启动应用逻辑...
基本上就这些。通过合理使用 set_exception_handler，可以让 PHP 应用更健壮、更安全，也能提供更好的错误反馈机制。 
