PHP调用Python脚本最常用的是exec、shell_exec和proc_open三个函数，本质是通过系统命令行启动Python进程；需显式指定Python绝对路径、处理编码、传参转义、超时控制及退出码检查。
PHP调用Python脚本最常用的是exec和shell_exec
PHP本身不内置Python运行时，所有“执行Python”的操作本质都是通过系统命令行启动python或python3进程。因此真正起作用的是PHP的进程执行函数，而非某个“专用于Python”的函数。
实际高频使用的是以下三个，按安全性和适用场景排序：
-
shell_exec()：返回命令完整输出（含换行），适合需要捕获Python脚本标准输出的场景，比如shell_exec('python3 /path/to/script.py') -
exec()：默认只返回最后一行输出，但可通过第二个参数传入数组接收全部行，更可控；注意第三个参数可捕获退出码，便于判断Python是否报错 -
proc_open()：复杂交互场景唯一选择，比如Python脚本需要持续读写stdin/stdout、设置超时、限制内存，但代码量明显增加
不推荐用system()或passthru()——前者直接输出到浏览器易引发XSS，后者绕过PHP输出控制，调试和异常捕获困难。
Python路径和环境问题常导致exec返回空或Command not found
PHP运行用户（如www-data、nginx）往往没有和当前终端一致的$PATH，也未必加载了你的conda/virtualenv环境。直接写python3 script.py大概率失败。
立即学习“PHP免费学习笔记（深入）”；
稳妥做法是显式指定解释器绝对路径，并激活环境（如果必须）：
huaweicloud-python-sdk-helper
下载
华为云 Python SDK 查询工具。自动发现已安装 SDK 的服务包、Client类、API 方法、入参详情、类信息（__init__ 参数、属性、类型、描述），支持关键字搜索，快速定位目标 API 使用方法。
- 先在终端运行
which python3，得到类似/usr/bin/python3的路径，硬编码进PHP - 虚拟环境需调用
/path/to/venv/bin/python，而不是source venv/bin/activate && python——source在非交互shell中无效 - 若Python脚本依赖相对路径（如读取同目录下
config.json），务必用cd /full/path && /usr/bin/python3 script.py切换工作目录
传参和编码问题让shell_exec返回乱码或截断
PHP调用Python时，中文参数、JSON输出、特殊字符（如单引号、$符号）极易出问题，根源是shell解析和字符编码双重干扰。
关键处理点：
- 所有外部输入（尤其是用户提交的字符串）必须用
escapeshellarg()包裹，例如：shell_exec("python3 script.py " . escapeshellarg($user_input)) - Python脚本开头加
# -*- coding: utf-8 -*-，且输出前设sys.stdout.reconfigure(encoding='utf-8')（Python 3.7+）或用print(..., file=sys.stdout)避免编码fallback - 避免在命令行拼接JSON字符串——改用临时文件或stdin传入：PHP写JSON到
tempfile.json，Python用json.load(open(sys.argv[1]))读取
超时、僵尸进程和错误捕获必须主动处理
Python脚本卡死、无限循环、或未关闭数据库连接，会导致PHP子进程滞留，最终耗尽服务器资源。
不能只依赖shell_exec()，要组合控制：
- 用
proc_open()配timeout流上下文（PHP 7.4+支持stream_set_timeout）或Linuxtimeout命令：timeout 10s python3 script.py - 始终检查返回值和退出码：
exec($cmd, $output, $return_code); if ($return_code !== 0) { /* Python出错了 */ } - Python端用
try/except兜底并print明确错误信息，避免PHP只能看到NULL或空字符串
真正麻烦的从来不是“怎么调”，而是“调崩了怎么知道哪里崩、怎么不让它崩完还赖着不走”。路径、编码、超时、错误码这四点漏掉任意一个，线上就容易静默失败。
