如何在Laravel中使用Symfony Process组件展示Python Plotly生成的图表

• 路径配置错误：终端执行时是在public目录下使用相对路径定位Python脚本，PHP代码中调用时漏了rcs层级，且相对路径依赖进程工作目录，稳定性差
• Plotly输出逻辑错误：fig.show()是在本地图形环境中唤起浏览器展示图表，web请求对应的运行用户无图形界面权限，也不会将图表内容输出到标准输出，因此PHP无法拿到返回内容

1. 修正Python脚本输出逻辑 #

不要使用fig.show()，改为将图表HTML内容直接打印到标准输出：

import plotly.express as px

df = px.data.gapminder().query("continent=='Oceania'")
fig = px.line(df, x="year", y="lifeExp", color='country')
# 输出可直接嵌入页面的图表HTML片段
print(fig.to_html(full_html=False, include_plotlyjs='cdn'))

参数说明：

• full_html=False 仅生成图表核心片段，不需要完整HTML文档结构
• include_plotlyjs='cdn' 自动引入CDN版Plotly.js依赖，无需前端单独引入

2. 修正Laravel控制器代码 #

使用Laravel内置的storage_path辅助函数生成绝对路径，避免相对路径依赖问题，同时增加错误输出排查逻辑：

<?php

namespace App\Http\Controllers;

use Symfony\Component\Process\Exception\ProcessFailedException;
use Symfony\Component\Process\Process;

class FooController extends Controller
{
    public function bar()
    {
        // 用绝对路径定位Python脚本，避免工作目录变化导致的路径错误
        $process = new Process(['python3.8', storage_path('app/public/rcs/line-chart.py')]);
        // 设置超时时间，避免复杂图表生成时超时
        $process->setTimeout(30);

        try {
            $process->mustRun();
            return $process->getOutput();
        } catch (ProcessFailedException $exception) {
            // 输出标准错误信息方便排查问题
            return $exception->getMessage() . '<br>错误输出：' . $process->getErrorOutput();
        }
    }
}

3. 权限校验 #

确保web服务运行用户（通常是www-data、nginx等）拥有python3.8的执行权限，以及对应Python脚本的读取权限，依赖的Plotly等包要安装在对应用户可访问的路径下。

除了使用Plotly.js前端版本外，有以下比调用Symfony Process更稳定高效的方案：

• 直接使用PHP端Plotly扩展：比如laravel-plotly这类扩展包，可直接在PHP中构造图表配置，输出前端可渲染的结构，无跨进程调用开销，稳定性最高，适合绝大多数场景
• 封装Python HTTP服务：将图表生成逻辑用FastAPI/Flask封装为独立HTTP接口，Laravel通过内网HTTP请求获取结果，相比每次fork进程性能更高，适合请求量较大、图表逻辑复杂的场景
• 静态缓存预生成：如果图表数据更新频率低，可以提前用定时任务跑Python脚本生成图表HTML/图片，存储到公共磁盘，Laravel直接返回静态资源即可，性能最好，没有实时计算开销

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