利用Composer库实现PHP底层的零开销异常捕获与上报-composer-PHP中文网

php无真正零开销异常捕获，仅未触发异常时无运行时开销；应使用set_exception_handler/set_error_handler全局接管throwable，配合monolog+syslog异步上报，严禁在handler中执行可能再抛异常或阻塞的操作。

利用composer库实现php底层的零开销异常捕获与上报

PHP 本身没有“零开销异常捕获”——只要抛出 Exception，栈帧、对象实例化、trace 生成就已发生，不存在真正意义上的零成本。所谓“零开销”，实际是指在**未触发异常时完全不引入运行时判断或代理层**，且上报逻辑异步、非阻塞、可丢弃。

为什么不能用 try/catch 包裹所有业务代码来实现“捕获”

主动 try/catch 不仅无法捕获未被捕获的致命错误（如 Fatal error、Parse error），还会显著增加字节码执行路径分支，破坏 opcache 内联优化，尤其在高频调用函数中引入可观测的性能下降。更重要的是，它把异常处理逻辑耦合进业务流程，违背关注点分离原则。

set_exception_handler() 和 set_error_handler() 是唯一能全局接管未捕获异常/错误的机制
PHP 7+ 的 Throwable 接口统一了 Exception 和 Error，必须同时处理两者
任何在 handler 中执行的同步网络 I/O（如直接 file_get_contents() 上报）都会阻塞当前请求，属于典型反模式

推荐方案：monolog + monolog-handler-syslog + 自定义异步 handler

不要用 monolog 默认的 StreamHandler 直写文件或 HTTP，它同步阻塞。应组合使用：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

用 monolog 做日志抽象层，保持结构化输出（context 和 extra 字段保留 trace、request_id、server info）
用 monolog-handler-syslog 将日志写入 syslog（内核级 ring buffer，毫秒级延迟，无磁盘 I/O 压力）
配合 rsyslog 或 fluentd 转发到远端收集服务（如 Loki、ELK），实现真正的解耦与削峰

示例注册方式：

$logger = new \Monolog\Logger('app');
$syslog = new \Monolog\Handler\SyslogHandler('php-app', LOG_USER, \Monolog\Logger::ERROR);
$logger->pushHandler($syslog);

set_exception_handler(function (\Throwable $e) use ($logger) {
    $logger->error('Uncaught exception', [
        'message' => $e->getMessage(),
        'class'   => get_class($e),
        'file'    => $e->getFile(),
        'line'    => $e->getLine(),
        'trace'   => $e->getTraceAsString(),
        'request_id' => $_SERVER['REQUEST_ID'] ?? 'unknown',
    ]);
});

set_error_handler(function ($severity, $message, $file, $line) use ($logger) {
    if (!(error_reporting() & $severity)) return false;
    $logger->error("PHP Error: $message", ['severity' => $severity, 'file' => $file, 'line' => $line]);
});