PHP调用Python脚本需通过exec等函数启动外部进程，关键在于确保Python路径正确、权限充足、错误可捕获、参数防注入、输出可解析且编码统一，并重视超时与日志调试。
PHP 直接“执行” Python 脚本不是内置能力，而是通过系统命令调用外部进程实现的；本质是 shell_exec、exec 等函数启动一个独立的 python 进程，所以必须确保 PHP 进程有权限、环境可访问、路径正确，否则会静默失败或报错。
确认 Python 在服务器上可用且 PATH 正确
PHP 调用 python 命令的前提是：Web 服务器（如 Apache 或 Nginx + PHP-FPM）运行的用户能从 shell 找到 python 可执行文件。常见问题不是“不会写 PHP”，而是 python 根本不在 $PATH 里，或者用的是 python3 而代码硬写了 python。
- 在终端切到 Web 用户身份（如
sudo -u www-data bash）执行which python3，记下完整路径（比如/usr/bin/python3） - PHP 中优先用绝对路径调用，避免依赖 PATH：
exec('/usr/bin/python3 /path/to/script.py') - 如果脚本依赖虚拟环境，不要只激活环境，而应直接调用环境里的解释器：
/var/www/venv/bin/python
用 exec 或 shell_exec 拿到输出并处理错误
别用 system——它直接输出到页面，不适合取结果；exec 更可控，能拿到最后一行输出和完整输出数组；shell_exec 返回整个 stdout 字符串，但不提供 stderr。实际开发中建议组合使用。
-
exec('python3 script.py 2>&1', $output, $return_code)：把 stderr 重定向到 stdout，$output 是数组，$return_code 是退出码（0 表示成功） - 检查
$return_code !== 0是判断是否出错的第一步，比检查输出内容更可靠 - Python 脚本里别用
input()或阻塞式 I/O，PHP 调用默认无交互上下文，会卡住 - 传参时注意 shell 注入风险：用
escapeshellarg($arg)包裹每个外部输入，例如exec('python3 script.py ' . escapeshellarg($user_input))
Python 脚本输出要明确、可解析
PHP 不懂 Python 的 print 格式，也不自动 JSON 解析。如果你希望 PHP 拿到结构化数据，Python 那边得主动输出纯文本或标准格式，并控制编码。
立即学习“PHP免费学习笔记（深入）”；
- Python 脚本末尾推荐用
print(json.dumps({"result": "ok", "data": 42}))，然后 PHP 用json_decode($output[0], true)解析 - 确保 Python 输出 UTF-8，避免中文变乱码：脚本开头加
# -*- coding: utf-8 -*-，print 前设sys.stdout.reconfigure(encoding='utf-8')（Python 3.7+）或用print(..., encoding='utf-8') - 不要依赖 print 的换行行为——
exec的 $output 数组每行一个元素，但空行、异常 traceback 都会进数组，需过滤或约定协议
权限、超时与调试技巧
线上环境最常踩的坑不是语法，是权限和超时：PHP 进程可能被禁用 exec，或脚本跑太久被 kill，又或者日志全丢在黑洞里。
- 检查
disable_functions是否禁用了exec/shell_exec：在 PHP 中运行print_r(ini_get('disable_functions')) - 加超时控制：Linux 下可用
timeout 10s python3 script.py（注意timeout命令本身也要在 PATH 中） - 调试时先绕过 PHP，在命令行用 Web 用户身份手动跑一遍完整命令，看 stdout/stderr 和返回码
- 记录日志别只靠 echo：把
$output和$return_code写进文件，比如file_put_contents('/tmp/py_debug.log', print_r([$output, $return_code], true), FILE_APPEND)
真正卡住的地方往往不是“怎么写那行 exec”，而是 Python 脚本在 Web 用户下缺模块、没权限读文件、编码不一致、或者超时后 PHP 什么提示都不给——动手前先切用户、跑命令、看返回码，比查 PHP 函数文档管用得多。
