Docker+Laravel+Roadrunner环境下SPX Profiler启用失败求助

1. 确认SPX配置在Roadrunner环境中生效 #

Roadrunner作为常驻进程，PHP配置加载逻辑和FPM模式不同，需做以下检查：

• 进入Docker容器执行 php -i | grep spx，确认输出的配置项中spx.http_profiling_enabled为On、spx.http_enabled为On，且spx.http_key、spx.data_dir与你设置的一致。
• 检查Roadrunner的.rr.yaml配置，确保php.settings节点没有覆盖SPX的相关配置参数。

2. 适配Roadrunner常驻进程特性，手动初始化SPX #

由于Roadrunner进程常驻，SPX的HTTP触发逻辑无法自动初始化，需在Laravel启动阶段手动配置：

• 在app/Providers/AppServiceProvider.php的boot方法中添加初始化代码：

if (extension_loaded('spx')) {
    // 强制启用HTTP profiling
    spx_config_set('http_profiling_enabled', true);
    // 初始化SPX HTTP处理器
    spx_http_init();
}

注意：这段代码仅在Roadrunner worker启动时执行一次，不要放在请求生命周期的中间件中重复执行。

3. 避免Laravel路由拦截SPX面板请求 #

Laravel的路由规则可能会拦截SPX的面板请求，需优先处理SPX的HTTP请求：

• 在routes/web.php最顶部添加前置路由逻辑：

if (extension_loaded('spx') && isset($_GET['SPX_KEY']) && $_GET['SPX_KEY'] === 'dev') {
    spx_http_handle();
    exit;
}

让SPX直接处理面板请求，跳过Laravel的路由中间件和控制器逻辑。

4. 验证SPX数据目录的访问权限 #

虽然控制台能生成dump文件，但HTTP面板需要读取目录内的文件，需确保权限正确：

• 在Docker容器内执行 chmod -R 777 /spx_dumps（测试环境临时使用，生产环境建议将目录所有者设置为Roadrunner运行用户，如www-data）。
• 确认/spx_dumps目录的读写权限对Roadrunner进程开放。

5. 绕过HTTP面板，手动控制Profiling #

如果HTTP面板仍无法访问，可直接在代码中手动触发profiling：

• 在需要分析的代码块前添加：

if (extension_loaded('spx')) {
    spx_config_set('profiling_enabled', true);
    spx_profiler_start();
}

• 代码执行结束后生成dump文件：

if (extension_loaded('spx')) {
    $dumpPath = spx_profiler_stop();
    \Log::info('SPX分析文件已生成：' . $dumpPath);
}

随后在容器内使用SPX CLI工具查看结果：spx view /spx_dumps/[具体文件名].spx。

6. 调整Roadrunner Worker配置，避免进程复用冲突 #

Roadrunner的worker复用机制可能导致SPX状态异常，可临时调整配置测试：

• 在.rr.yaml中设置 worker.pool.num_workers: 1，减少worker复用带来的状态问题。
• 重启Roadrunner服务，确保配置生效。

内容的提问来源于stack exchange，提问作者M-A-X