PHP调用Python脚本时虚拟环境不生效，根本原因是PHP未使用虚拟环境中的Python解释器，必须显式指定其绝对路径（如/path/to/venv/bin/python），并处理工作目录、环境变量、权限及路径配置问题。
PHP调用Python脚本时，虚拟环境不生效的典型表现
直接用 exec("python script.py") 跑起来，但报错说缺包（比如 ModuleNotFoundError: No module named 'requests'），而你在终端里激活虚拟环境后手动运行却完全正常——这说明 PHP 进程根本没走你的虚拟环境 Python 解释器。
必须用虚拟环境里的 python 可执行文件绝对路径
PHP 不认 source venv/bin/activate 这套 shell 激活逻辑，它只认具体可执行文件。你得找到虚拟环境中真实的 python 二进制路径，例如：
- Linux/macOS：通常是
venv/bin/python（相对路径）或/full/path/to/venv/bin/python（绝对路径） - Windows：
venv\Scripts\python.exe
然后在 PHP 中显式调用它：
$cmd = '/full/path/to/venv/bin/python /full/path/to/script.py'; exec($cmd, $output, $return_code);
⚠️ 绝对路径是关键：PHP 的执行用户（如 www-data、nginx 或 apache 用户）没有 shell 环境变量，which python 或 python 都会 fallback 到系统 Python。
立即学习“PHP免费学习笔记（深入）”；
传参、环境变量和权限问题要一并处理
光换解释器还不够，常见连带问题包括：
- 脚本依赖当前工作目录？用
cd /path/to/script && /venv/bin/python script.py或先chdir()切目录 - 需要额外环境变量（如
PATH、LD_LIBRARY_PATH）？用env命令包裹：env PATH="/venv/bin:$PATH" /venv/bin/python script.py - PHP 进程用户无权读取虚拟环境目录？检查
venv/目录权限，确保 web 用户有执行（x）权限到每一级父目录，有读（r）权限到venv/bin/python和venv/lib/python*/site-packages/ - Windows 下注意反斜杠转义和空格路径：改用双引号包裹完整路径，或用
escapeshellarg()
更稳的方式：封装成独立服务而非直调 Python
如果脚本执行时间长、并发高，或需复用虚拟环境状态（比如加载大模型），直接 exec 容易卡住或超时。这时更适合：
- 用
venv/bin/python -m http.server 8000启一个轻量 API（配合 Flask/FastAPI 更佳） - PHP 改用
file_get_contents("http://localhost:8000/run")或 cURL 调用 - 把虚拟环境启动和服务绑定写成 systemd service 或 supervisor task，脱离 PHP 生命周期管理
这种分离方式绕开了 shell 权限、路径、环境变量所有坑，也更容易调试日志和控制资源。
真正容易被忽略的是：虚拟环境路径写死在 PHP 代码里后，部署时没同步更新路径，或者换了 Python 版本导致 venv/lib/python3.x 子目录名变化——建议把虚拟环境路径抽成配置项，且上线前用 ls -l /path/to/venv/bin/python 实际验证存在性。
