PHP调用Python脚本应优先使用proc_open而非exec，因前者支持stdin/stdout/stderr三路通信、可设超时、避免环境隔离与编码问题；exec仅适用于极轻量、无交互、路径和环境明确的场景。
PHP 调用 Python 脚本，exec 是最直接但最易出错的方式
直接用 exec 执行 Python 脚本在开发初期看似简单，实际上线后常因路径、环境、编码、超时等问题失败。它适合「只取结果、不关心过程、脚本极轻量」的场景，比如调用一个纯计算型 calc.py 输出单行数字。
常见错误现象：exec('python3 script.py', $out) 返回空数组、$out 为空、或报错 Command not found —— 本质是 PHP 进程找不到 python3 可执行文件，或当前用户环境变量与 Web 服务器（如 www-data）不一致。
- 务必用绝对路径调用 Python 解释器，例如
/usr/bin/python3或/opt/homebrew/bin/python3（macOS M1/M2） - Python 脚本路径也建议用绝对路径，避免相对路径在不同工作目录下失效
- 加
2>&1捕获 stderr，否则 Python 的异常（如ImportError）完全看不到：exec('/usr/bin/python3 /var/www/scripts/task.py 2>&1', $output, $return_code) - 设置超时：原生
exec不支持超时，需配合proc_open或封装 shell 命令（如timeout 10s python3 ...），否则卡住会拖垮整个 PHP 请求
需要传参、读输出、控制生命周期？必须用 proc_open
exec 是“发射即忘”，而 proc_open 提供 stdin/stdout/stderr 三路管道，能真正实现子进程通信。这是处理交互式 Python 脚本（比如要输入用户名、等待模型加载、分块接收 JSON 流）的唯一可靠方式。
典型使用场景：PHP 向 Python 发送一段文本，Python 调用 NLP 模型返回结构化 JSON，PHP 解析后响应前端。
立即学习“PHP免费学习笔记（深入）”；
- 必须显式配置描述符数组，例如：
$descriptors = [['pipe', 'r'], ['pipe', 'w'], ['pipe', 'w']]（分别对应子进程的 stdin/out/err） - Python 脚本里别用
input()等阻塞读，改用sys.stdin.read()或sys.stdin.readline()，并确保写完立刻sys.stdout.flush() - PHP 端写入后要
fclose($pipes[0])，否则 Python 可能一直等 EOF；读取时用fgets()或stream_get_contents()，避免死锁 - 记得
proc_close()，否则子进程可能残留成僵尸进程
Python 报 ModuleNotFoundError？不是 PHP 的锅，是环境隔离问题
Web 服务器用户（如 nginx + php-fpm 下的 www-data）通常没有权限访问你个人用户下的 pip install 包，或压根没装 virtualenv 里的包。此时 exec('python3 -c "import torch"') 直接失败。
- 先确认目标用户能跑通：切到 Web 用户执行
sudo -u www-data /usr/bin/python3 -c "import sys; print(sys.path)"，看输出路径是否包含你的包位置 - 推荐方案：用绝对路径调用虚拟环境内的 Python，例如
/var/www/venv/bin/python3，而非系统全局的python3 - 临时方案（仅调试）：在 PHP 中设置环境变量，如
putenv('PYTHONPATH=/var/www/venv/lib/python3.9/site-packages')，但不可靠，优先走虚拟环境路径 - 注意：某些包（如
torch）依赖系统级动态库（libgomp.so.1），需确保 Web 用户也能加载，用ldd /var/www/venv/lib/python3.9/site-packages/torch/lib/libtorch.so检查
别忽略字符编码和换行符——PHP 和 Python 默认不一致
PHP exec 拿到的输出是 raw bytes，而 Python 3 默认用 UTF-8，但若脚本里用了 print('中文') 且服务器 locale 是 C，可能触发 UnicodeEncodeError；反过来，PHP 用 mb_convert_encoding() 处理时又容易误判编码。
- Python 端显式指定 stdout 编码：启动时加
-X utf8参数，或脚本开头设sys.stdout.reconfigure(encoding='utf-8')（Python 3.7+） - PHP 端统一用
mb_convert_encoding($output, 'UTF-8', 'auto')，但更稳妥的是让 Python 输出 base64 编码后的字符串，PHP 再base64_decode()，彻底规避编码争议 - Windows 下换行符是
\r\n，Linux 是\n，用trim($output, "\r\n")比trim($output)更精准
跨语言调用真正难的从来不是语法，而是环境可见性、I/O 边界和错误归因——Python 报错信息卡在 stderr 里，PHP 却只盯着 stdout；Python 进程卡死，PHP 却没设超时；包装好了，但 LD_LIBRARY_PATH 没透传。每一步都得亲手验证，不能假设“它应该能跑”。
