在PHP项目中调用Python脚本完成特定功能是很常见的需求，比如调用Python的机器学习模型、处理复杂的数据分析任务等，要实现这个功能需要先完成一系列环境准备工作。
基础环境准备
首先需要在服务器或本地开发环境中同时安装PHP和Python，两者没有严格的版本绑定要求，但是建议选择稳定的主流版本，比如PHP 7.4及以上，Python 3.6及以上。安装完成后需要确认两个环境都能正常运行。
确认PHP环境可用
在命令行执行以下命令，能输出PHP版本信息说明PHP环境安装成功：
php -v
确认Python环境可用
在命令行执行以下命令，能输出Python版本信息说明Python环境安装成功：
python --version # 部分系统可能需要用python3命令 python3 --version
核心依赖与配置
PHP执行Python脚本不需要额外安装专门的扩展依赖，核心依赖是系统层面的环境配置，主要分为以下几个部分。
配置系统环境变量
需要保证Python的可执行文件路径已经添加到系统的环境变量中，这样PHP在执行命令的时候才能直接找到Python程序。如果没配置环境变量，PHP调用的时候会提示找不到Python命令。
- Windows系统：将Python安装目录（比如C:Python39）和Scripts目录（C:Python39Scripts）添加到系统PATH变量中
- Linux系统：一般Python安装后会自动配置环境变量，如果没有可以编辑/etc/profile文件添加对应路径
安装Python依赖包
如果你的Python脚本中用到了第三方库，比如numpy、pandas、requests等，需要提前用pip安装对应的依赖包，否则Python脚本执行的时候会报模块找不到的错误。
# 安装单个依赖 pip install requests # 安装多个依赖，requirements.txt是依赖列表文件 pip install -r requirements.txt
PHP配置调整
需要确认PHP的配置文件php.ini中，允许执行系统命令的相关函数没有被禁用。重点检查disable_functions配置项，确保exec、shell_exec、system等函数不在禁用列表中。如果是Linux系统，还需要保证运行PHP的用户（比如www-data）有执行Python脚本的权限。
PHP调用Python的示例代码
PHP可以通过exec、shell_exec等函数执行Python命令，下面是一个简单的调用示例，假设我们有一个test.py的Python脚本，内容如下：
import sys
# 接收PHP传递的参数
param = sys.argv[1]
print(f"PHP传递的参数是：{param}")
result = int(param) * 2
print(result)
PHP调用这个脚本的代码如下：
<?php
// 要传递给Python的参数
$param = 10;
// 要执行的Python命令，注意如果系统用python3命令需要替换成python3
$cmd = "python test.py " . $param;
// 执行命令并获取输出
exec($cmd, $output, $return_code);
if ($return_code === 0) {
echo "执行成功，输出结果：<br/>";
print_r($output);
} else {
echo "执行失败，错误码：" . $return_code;
}
?>
常见问题排查
如果执行过程中出现报错，可以按照以下步骤排查：
- 首先检查Python脚本本身能不能直接在命令行正常运行，排除脚本本身的语法错误
- 检查PHP执行的命令路径是否正确，可以先用绝对路径调用Python，比如/usr/bin/python3 test.py，确认是不是环境变量问题
- 检查Python脚本和依赖的权限，保证运行PHP的用户有读取和执行脚本的权限
- 如果是Windows系统，注意路径的反斜杠需要转义，或者使用正斜杠作为路径分隔符
注意：在生产环境中执行系统命令存在一定安全风险，不要直接拼接用户输入的参数到命令中，避免命令注入攻击，必要时需要对输入参数做严格的过滤和校验。