如何在Symfony开发环境中捕获并处理所有异常（含PHP语法错误）

核心原因：PHP语法错误的特殊性 #

PHP语法错误（如未闭合的括号、错误关键字使用）会在Symfony内核初始化之前触发，此时kernel.exception事件尚未注册，自定义异常控制器也未加载，因此常规的Symfony异常处理机制无法捕获这类错误。

解决方案步骤 #

1. 注册PHP原生错误处理逻辑 #

在项目入口文件（通常为public/index.php）最顶部添加原生错误处理函数，将致命错误转化为可处理的异常，并通过 shutdown 函数捕获内核启动前的错误：

// public/index.php 最顶部位置
set_error_handler(function ($severity, $message, $file, $line) {
    if (!(error_reporting() & $severity)) {
        return;
    }
    throw new ErrorException($message, 0, $severity, $file, $line);
});

register_shutdown_function(function () {
    $error = error_get_last();
    // 捕获语法错误、致命编译/核心错误
    if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
        // 这里执行你的AI推荐逻辑，然后输出调试内容
        header('Content-Type: text/html; charset=utf-8');
        echo '<h1>PHP语法/致命错误</h1>';
        echo '<div class="error-info">';
        echo '<p>错误信息：' . htmlspecialchars($error['message']) . '</p>';
        echo '<p>触发文件：' . htmlspecialchars($error['file']) . '</p>';
        echo '<p>行号：' . $error['line'] . '</p>';
        echo '</div>';
        // 插入AI推荐内容的渲染逻辑
        echo '<div class="ai-recommendations">';
        echo '<h3>AI修复建议</h3>';
        // 示例：调用你的AI服务获取推荐
        // $recommendations = $yourAiService->getFixSuggestions($error);
        // foreach ($recommendations as $rec) {
        //     echo '<p>' . htmlspecialchars($rec) . '</p>';
        // }
        echo '</div>';
        exit;
    }
});

2. 整合Symfony调试环境（开发模式） #

若要复用Symfony调试页面的样式或服务，可在shutdown函数中手动加载必要的Symfony组件：

register_shutdown_function(function () {
    $error = error_get_last();
    if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
        // 加载自动加载器
        require dirname(__DIR__).'/vendor/autoload.php';
        
        // 强制设置开发环境
        $_ENV['APP_ENV'] = 'dev';
        $_ENV['APP_DEBUG'] = '1';

        // 实例化自定义AI错误处理服务
        $aiHandler = new \YourBundle\Service\AiErrorRecommendationService();
        $recommendations = $aiHandler->generateSuggestions($error);

        // 输出带Symfony调试风格的页面
        echo '<!DOCTYPE html>';
        echo '<html lang="en">';
        echo '<head><title>Symfony Dev Error with AI Suggestions</title></head>';
        echo '<body style="margin: 2rem; font-family: monospace;">';
        echo '<h1 style="color: #dc3545;">PHP语法错误</h1>';
        echo '<pre style="background: #f8f9fa; padding: 1rem; border-radius: 4px;">';
        echo htmlspecialchars($error['message']) . ' in ' . $error['file'] . ':' . $error['line'];
        echo '</pre>';
        if (!empty($recommendations)) {
            echo '<h3 style="color: #0d6efd;">AI修复建议</h3>';
            echo '<ul style="list-style-type: disc; padding-left: 1.5rem;">';
            foreach ($recommendations as $rec) {
                echo '<li>' . htmlspecialchars($rec) . '</li>';
            }
            echo '</ul>';
        }
        echo '</body></html>';
        exit;
    }
});

3. 调整PHP配置确保错误可见 #

在开发环境的php.ini中配置以下参数，避免错误被静默处理：

display_errors = On
error_reporting = E_ALL
log_errors = On

注意事项 #

• 仅在开发环境启用该逻辑，生产环境应关闭错误显示，改为日志记录。
• 原生错误处理函数会捕获所有PHP级别错误，可根据需求过滤非致命错误（如警告）。
• 内核启动前无法使用Symfony完整DI容器，需手动实例化依赖服务或使用轻量逻辑。

内容的提问来源于stack exchange，提问作者Nicolas Potier