PHP调用Python失败主因是环境、权限、路径或错误捕获问题；需确认Python路径、用绝对路径调用、检查www-data用户权限、重定向stderr获取真实错误，并排查disable_functions等安全限制。
PHP 运行 Python 脚本失败，通常不是 PHP 或 Python 本身坏了，而是执行环境、权限、路径或交互方式出了问题。关键要分清：你是用 exec、shell_exec、system 等函数调用 Python，还是通过 Web 服务器（如 Apache/Nginx + PHP-FPM）触发的？后者限制更多。
确认 Python 命令在 PHP 可访问的环境中存在
PHP 子进程继承的是 Web 服务器用户的环境（比如 www-data 或 nginx），不是你登录终端时的环境。它可能根本找不到 python 或 python3 命令。
- 在 PHP 中加一行测试：
echo shell_exec('which python3 2>&1');，看是否返回路径（如/usr/bin/python3） - 如果为空或报错“command not found”，说明 PATH 不包含 Python；改用绝对路径调用，例如：
shell_exec('/usr/bin/python3 /path/to/script.py') - 检查目标用户是否有执行权限：
sudo -u www-data /usr/bin/python3 --version（在服务器终端中运行）
检查脚本路径、权限和工作目录
PHP 执行时的当前工作目录通常是 Web 文档根目录（如 /var/www/html），不是你的脚本所在目录。相对路径容易出错。
- 使用绝对路径写脚本位置：
/var/www/myapp/script.py，别用./script.py或../scripts/script.py - 确保 PHP 进程用户（如
www-data）对 Python 脚本有读取权限，对涉及的输入/输出文件或目录有读写权限 - 可在 PHP 中先切换工作目录：
chdir('/var/www/myapp'); exec('python3 script.py', $output, $return);
捕获并查看真实错误信息
默认情况下，PHP 的执行函数不显示 Python 的 stderr（比如 import 错误、语法错误、模块缺失），导致“静默失败”。
立即学习“PHP免费学习笔记（深入）”；
- 把 stderr 重定向到 stdout：
$output = shell_exec('/usr/bin/python3 /path/to/script.py 2>&1'); - 或用
exec()获取返回码：exec('/usr/bin/python3 script.py 2>&1', $output, $return_code); var_dump($return_code, $output); - 常见错误示例：
ModuleNotFoundError: No module named 'requests'→ 需在系统级安装该包：sudo pip3 install requests（注意：不要用用户级 pip，PHP 进程看不到）
避免 Web 环境下的常见限制
共享主机或加固过的服务器常禁用执行函数，或限制网络、临时目录、子进程等。
- 检查
disable_functions是否禁用了exec、shell_exec等（查看phpinfo()或php -i | grep disable_functions） - Python 脚本若尝试访问网络（如调 API）、读写
/tmp、或启用多线程/子进程，可能被 SELinux、AppArmor 或 PHP 安全模式拦截 - 临时调试可先在命令行模拟 PHP 用户执行：
sudo -u www-data /usr/bin/python3 /path/to/script.py，复现并定位问题
不复杂但容易忽略。从环境、路径、权限、错误输出四点挨个验证，90% 的问题都能快速定位。
