1. PHP错误捕获基础
1.1 异常模型与错误的区分
异常和错误在 PHP 中属于不同的处理路径，但都需要被程序员适当管理。异常通常是可控的、可捕获的事件，而错误往往在运行时产生，若不处理可能导致应用中断。了解两者的关系，可以帮助你设计统一的错误捕获策略，避免前端用户看到未处理的崩溃信息。
在 PHP 的类型体系中，Throwable 是 异常栈 的顶层接口，所有可抛出的对象都实现了它。通过抓取 Throwable，你可以覆盖 Exception 与 Error，实现统一处理。下面的要点值得记住：异常是可捕获的逻辑单元，而错误往往需要通过转换成为异常进行处理。
1.2 基本的 try-catch
最常见的错误捕获方式是通过 try-catch 结构。try 块包裹可能抛出异常的代码，catch 块用于捕获并处理异常。使用 Throwable 可以一次性捕获所有类型的抛出对象，提升健壮性。
try {// 可能抛出异常的逻辑$result = someRiskyOperation();
} catch (Throwable $e) {// 全局性处理：记录日志、释放资源、返回友好错误信息error_log('Error: ' . $e->getMessage() . ' in ' . $e->getFile() . ':' . $e->getLine());// 进一步的错误网关处理
}
在实际场景中，你也可以对不同类型的异常做分派处理，例如先捕获 SpecificException，再捕获 Throwable，以实现逐级容错。分层捕获有助于提供更细粒度的错误信息和纠错路径。
2. 从 try-catch 到全局处理
2.1 全局异常处理器的实现
为了避免遗漏的异常导致应用崩溃，你可以设置全局的异常处理器。通过 set_exception_handler，你可以将未被捕获的异常统一落到一个逻辑统一的入口，集中做日志、告警和响应格式化等工作。实现时，捕获顶层 Throwable，并输出一个对用户友好的错误信息。
// 全局异常处理器
set_exception_handler(function($exception) {// 记录异常error_log('[Unhandled Exception] ' . $exception->getMessage());// 给前端的友好返回（示意）echo json_encode(['success' => false,'error' => '系统异常，请稍后再试。']);
});
这里的重点在于将异常向外抹平，防止未捕获的异常暴露内部实现细节。全局处理器是实现统一错误策略的关键入口，也是现代应用的基石。
2.2 将错误转化为异常的策略
许多 PHP 代码中仍有大量错误类型的回调、警告、通知。为了统一处理，可以使用 set_error_handler 将这些错误转化为异常，借助 try-catch 进行统一处理。这样做的好处是可以通过一个入口点完成日志、重试、降级等策略。
// 将错误转化为异常
class ErrorToException extends \ErrorException {}set_error_handler(function($severity, $message, $file, $line) {throw new ErrorToException($message, 0, $severity, $file, $line);
});try {// 可能触发警告/通知的代码$result = file_get_contents('非存在路径');
} catch (Throwable $e) {error_log('Converted error to exception: ' . $e->getMessage());
}
统一转换后，后续就可以通过统一的
异常处理流程对错误做日志、告警、重试等处理，提升稳定性与可观测性。
3. 自定义异常与设计
3.1 自定义异常类的编写
在复杂应用中，使用自定义异常可以让错误类型信息更清晰，便于上层调用者做出差异化处理。通常自定义异常应继承自 Exception 或 RuntimeException，并可附带自定义字段（如错误码、上下文数据等）。
// 自定义异常示例
class AppException extends \\Exception {protected $errorCode;public function __construct(string $message, int $code = 0, int $errorCode = 0, \\Throwable $previous = null) {parent::__construct($message, $code, $previous);$this->errorCode = $errorCode;}public function getErrorCode(): int {return $this->errorCode;}
}
自定义异常的一个重要好处是可以将错误来源与错误级别解耦，便于前后端分离的错误响应策略实现。
3.2 异常层级与错误码
设计一个合适的异常层级，可以让上层捕获更具体的异常类型，或通过统一的错误码进行前端展示。通常会有如下要点：一级层级区分业务错误与系统错误；错误码用于与前端契约化通信；上下文数据用于排错与追踪。
// 使用错误码进行统一响应
class ValidationException extends AppException {protected $errorCode = 1001;
}// 使用示例
try {validateUser($payload);
} catch (ValidationException $e) {// 针对参数问题返回 400http_response_code(400);echo json_encode(['errorCode' => $e->getErrorCode(), 'message' => $e->getMessage()]);
} catch (AppException $e) {// 其他业务错误http_response_code(422);echo json_encode(['errorCode' => $e->getErrorCode(), 'message' => $e->getMessage()]);
}
合理的异常层级设计能够提升代码的可维护性与错误定位效率，是大中型系统的核心实践。
4. 实战：日志、重试、与框架集成
4.1 日志与监控
错误捕获的价值在于可观测性。你应将异常信息、错误栈、调用上下文等写入日志，并尽量对关键异常触发告警。日志记录是运维与排错的第一手资料，通常配合一个可扩展的日志组件（如 Monolog）实现。
// 简易日志示例：使用 error_log 记录
try {$data = fetchDataFromApi();
} catch (Throwable $e) {// 记录详细栈信息，便于排错error_log(sprintf("[%s] %s in %s:%d\nTrace: %s",date('Y-m-d H:i:s'),$e->getMessage(),$e->getFile(),$e->getLine(),$e->getTraceAsString()));// 返回对用户友好的错误http_response_code(500);echo json_encode(['error' => '系统内部错误，请稍后再试。']);
}
日志的结构化与统一格式可以帮助你在后续的监控工具中进行聚合、筛选与告警设置，提高故障响应效率。
4.2 框架集成与最佳实践
在实际开发中，框架往往提供了完善的异常处理钩子与日志能力，例如集成 set_exception_handler、set_error_handler 与框架自带的异常中间件。遵循 PSR 标准（如 PSR-3 日志接口、PSR-7/PSR-15 请求/响应处理）有助于实现跨框架的一致性。
// 与框架中间件的简化示例（伪代码）
class AppExceptionHandler {public function handle(Throwable $e) {// 统一格式化响应return json_encode(['success' => false,'error' => $e->getMessage(),'code' => method_exists($e, 'getErrorCode') ? $e->getErrorCode() : 500]);}
}
通过将错误处理逻辑抽象为中间件/组件，可以实现跨控制器、跨服务的统一异常策略。框架集成的关键在于避免重复捕获、保证一致的错误返回，以及确保必要的上下文信息被记录。
