根本原因是PHP调用的Python解释器环境与开发终端不一致，需确认真实路径（python3 -c “import sys; print(sys.executable)”），用对应python -m pip安装依赖，并确保Web用户权限、绝对路径、错误捕获及SELinux等配置正确。
PHP 调用 python 脚本时报 “ModuleNotFoundError” 或 “No module named XXX”，根本原因不是 PHP 问题，而是 PHP 进程启动的 Python 解释器环境跟你的开发终端不一致——它用的是系统默认或指定路径下的 Python，而那个环境没装你要的包。
确认 PHP 实际调用的是哪个 Python
别猜，直接在 PHP 里打印出来：
&1'); echo "Python path: " . trim($output); ?>
常见情况包括：/usr/bin/python3（系统自带）、/usr/local/bin/python3（brew/macports）、/opt/homebrew/bin/python3（Apple Silicon Mac），甚至可能是 /var/www/.pyenv/shims/python（如果你用了 pyenv 但没全局生效）。
- 如果输出为空或报错，说明
python3不在 PATH 中，需显式指定绝对路径（如/usr/local/bin/python3） - PHP 的
shell_exec、exec等函数运行在 Web 服务器用户（如www-data、_www）下，该用户家目录、PATH、shell 配置都和你登录终端不同 -
which python3结果 ≠python3 -c "import sys; print(sys.executable)"，后者才是真实解释器路径，更准
给正确的 Python 安装依赖（不是 pip，是 pip3 对应那个 python3）
拿到上一步的真实路径后，用它来调 pip3，或者更稳妥：用 -m pip 模式安装：
立即学习“PHP免费学习笔记（深入）”；
