FatFree框架中记录运行端点与文件至数据库日志的最优方案咨询

当前debug_backtrace方案的局限性 #

你当前基于debug_backtrace()的方案只能捕获PHP调用栈中的文件，无法记录模板文件——原因是FatFree的模板渲染过程由框架内部处理，模板文件不会进入PHP的函数调用栈，因此该方案覆盖不全，并非最优选择。

FatFree原生Profiling方案 #

FatFree内置了Profiler组件，可以自动追踪请求的端点、加载的所有文件（包括PHP和模板）、执行时间等核心数据，是官方推荐的性能与请求追踪方案。

启用原生Profiler #

只需在框架初始化后添加一行配置：

$f3->set('PROFILER', true);

默认情况下，Profiler会在页面底部生成可视化面板展示数据，但我们可以通过事件监听将数据存入数据库。

扩展Profiler实现数据库日志 #

通过监听ONSHUTDOWN事件（请求结束时触发），提取Profiler收集的完整数据并写入数据库：

// 启用Profiler
$f3->set('PROFILER', true);

// 请求结束时写入日志到数据库
$f3->on('ONSHUTDOWN', function($f3) {
    $profiler = $f3->get('PROFILER');
    // 获取当前请求端点
    $endpoint = $f3->get('PATH');
    // 获取所有加载的文件（含PHP、模板等）
    $loadedFiles = $profiler->data['files'];
    // 获取请求总执行时间
    $executionTime = $profiler->data['total'];

    // 写入数据库（假设已配置好DB连接）
    $db = $f3->get('DB');
    $db->exec(
        'INSERT INTO request_logs (endpoint, loaded_files, execution_time, created_at) VALUES (?, ?, ?, NOW())',
        [$endpoint, json_encode($loadedFiles), $executionTime]
    );
});

该方案的优势：

• 原生组件兼容性强，无需手动处理文件追踪逻辑
• 自动覆盖所有框架加载的资源（包括模板、配置文件等）
• 附带执行时间、内存占用等额外数据，便于后续性能分析

自定义追踪方案（适合高度定制场景） #

如果不需要Profiler的全部功能，可通过FatFree的事件钩子实现精准追踪：

1. 记录端点：监听ONROUTE事件捕获当前请求路径
2. 记录模板文件：监听ONLOAD事件（模板加载时触发）捕获模板路径
3. 记录PHP文件：结合debug_backtrace()或框架的自动加载钩子收集PHP文件
4. 统一写入数据库：在ONSHUTDOWN事件中汇总数据并入库

示例代码：

// 初始化日志存储容器
$f3->set('request_log', [
    'endpoint' => '',
    'php_files' => [],
    'tpl_files' => []
]);

// 捕获请求端点
$f3->on('ONROUTE', function($f3) {
    $f3->set('request_log.endpoint', $f3->get('PATH'));
});

// 捕获模板文件
$f3->on('ONLOAD', function($f3, $tplPath) {
    $log = $f3->get('request_log');
    $log['tpl_files'][] = $tplPath;
    $f3->set('request_log', $log);
});

// 请求结束时汇总数据并写入数据库
$f3->on('ONSHUTDOWN', function($f3) {
    $log = $f3->get('request_log');
    // 从调用栈提取PHP文件
    $backtrace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
    foreach ($backtrace as $item) {
        if (isset($item['file']) && !in_array($item['file'], $log['php_files'])) {
            $log['php_files'][] = $item['file'];
        }
    }

    // 写入数据库
    $db = $f3->get('DB');
    $db->exec(
        'INSERT INTO request_logs (endpoint, php_files, tpl_files, created_at) VALUES (?, ?, ?, NOW())',
        [$log['endpoint'], json_encode($log['php_files']), json_encode($log['tpl_files'])]
    );
});

总结 #

• 仅依赖debug_backtrace()的方案并非最优，无法覆盖模板等非PHP资源的追踪
• FatFree原生Profiler是实现该需求的最佳选择，兼具易用性与完整性
• 自定义钩子方案适合需要高度定制日志内容的场景

内容的提问来源于stack exchange，提问作者Dariusz Rup