如何通过JavaScript和PHP从网页运行本地Python脚本？

问题场景 #

在Ubuntu 22的Apache2服务器上部署网页，预期流程是：点击页面按钮 → Ajax请求调用PHP脚本 → PHP传递参数运行本地Python脚本。但实际点击按钮后页面刷新，URL带表单参数，脚本未执行。

现有代码如下：

JavaScript按钮触发函数 #

function runScript() {
    runTime = document.config.time.value;
    repeats = document.config.repeats.value;
    performFWUpd = document.config.fwperform.value;
    systemType = document.config.system.value;
    phoneA = document.config.phoneAtype.value;
    phoneB = document.config.phoneBtype.value;

    $.ajax({
        url: 'http://ip_of_webserver_pc/callScript.php',
        type: 'POST',
        data: {
                runTime:runTime,
                repeats:repeats,
                performFWUpd:performFWUpd,
                systemType:systemType,
                phoneA:phoneA,
                phoneB:phoneB
              },
              success: function(data) {
              },
              error: function() {
                console.log('Error occured');
              }
    });
}

PHP脚本（callScript.php） #

<?php
    if (isset($_POST['runTime']) && isset($_POST['repeats']) && 
       isset($_POST['performFWUpd']) &&
       isset($_POST['systemType']) && isset($_POST['phoneA']) && isset($_POST['phoneB'])) {
          exec("var/www/python_script/main.py $_POST['runTime'] $_POST['repeats'] $_POST['performFWUpd'] $_POST['systemType'] $_POST['phoneA'] $_POST['phoneB'])");
    }
?>

Python脚本参数接收部分 #

import sys
...
if __name__ == "__main__":
  # Get parameters from script call arguments
  execTime = sys.argv[1]
  numOfRepeats = sys.argv[2]
  performFWUpdate = sys.argv[3]
  targetSystem = sys.argv[4]
  phone1 = sys.argv[5]
  phone2 = sys.argv[6]
  run()

核心问题原因 #

1. 表单默认提交行为未阻止：按钮大概率属于<form>标签内，点击时触发了表单的默认GET提交，导致页面刷新、URL带参数，Ajax请求被中断或根本没执行。
2. PHP exec命令错误：
   • 脚本路径错误：var/www/python_script/main.py是相对路径，Apache执行时的工作目录不是根目录，必须用绝对路径。
   • 未指定Python解释器：直接执行.py文件可能因缺少shebang或权限问题无法运行，应指定Python解释器路径。
   • 参数未转义：直接拼接用户输入到exec命令，存在命令注入风险，且参数含空格/特殊字符时会导致命令执行失败。
3. 权限不足：Apache运行用户（默认www-data）没有Python脚本的执行权限，或脚本依赖的资源无访问权限。
4. Ajax调试缺失：success回调无任何输出，无法确认PHP是否收到请求；error回调仅打印简单日志，无法定位具体错误。

分步解决方法 #

1. 阻止表单默认提交 #

修改JavaScript函数，添加阻止默认行为的逻辑，同时确保按钮的onclick绑定正确：

function runScript(event) {
    // 阻止默认表单提交行为
    if (event) event.preventDefault();

    runTime = document.config.time.value;
    repeats = document.config.repeats.value;
    performFWUpd = document.config.fwperform.value;
    systemType = document.config.system.value;
    phoneA = document.config.phoneAtype.value;
    phoneB = document.config.phoneBtype.value;

    $.ajax({
        url: 'callScript.php', // 建议用相对路径，避免跨域或IP硬编码问题
        type: 'POST',
        data: {
                runTime:runTime,
                repeats:repeats,
                performFWUpd:performFWUpd,
                systemType:systemType,
                phoneA:phoneA,
                phoneB:phoneB
              },
              success: function(data) {
                  console.log('请求成功，返回数据:', data); // 添加调试日志
              },
              error: function(xhr, status, error) {
                console.log('请求错误:', status, error); // 打印详细错误信息
              }
    });

    // 额外保险，阻止后续行为
    return false;
}

同时修改按钮的HTML：

<button onclick="return runScript(event);">运行脚本</button>

2. 修复PHP exec命令 #

修正路径、指定Python解释器、转义参数，同时捕获执行结果用于调试：

<?php
    // 开启错误显示（调试阶段用，生产环境关闭）
    error_reporting(E_ALL);
    ini_set('display_errors', 1);

    $requiredParams = ['runTime', 'repeats', 'performFWUpd', 'systemType', 'phoneA', 'phoneB'];
    $missingParams = [];
    foreach ($requiredParams as $param) {
        if (!isset($_POST[$param])) {
            $missingParams[] = $param;
        }
    }

    if (!empty($missingParams)) {
        echo "缺少参数: " . implode(', ', $missingParams);
        exit;
    }

    // 转义每个参数，防止命令注入和特殊字符问题
    $runTime = escapeshellarg($_POST['runTime']);
    $repeats = escapeshellarg($_POST['repeats']);
    $performFWUpd = escapeshellarg($_POST['performFWUpd']);
    $systemType = escapeshellarg($_POST['systemType']);
    $phoneA = escapeshellarg($_POST['phoneA']);
    $phoneB = escapeshellarg($_POST['phoneB']);

    // 绝对路径+指定Python解释器（可通过`which python3`确认路径）
    $pythonPath = '/usr/bin/python3';
    $scriptPath = '/var/www/python_script/main.py';
    $command = "$pythonPath $scriptPath $runTime $repeats $performFWUpd $systemType $phoneA $phoneB";

    // 捕获执行输出和返回码
    exec($command, $output, $returnVar);

    // 返回调试信息
    echo "命令执行结果:\n";
    echo "返回码: $returnVar\n";
    echo "输出内容:\n" . implode("\n", $output);
?>

3. 调整权限 #

1. 确保Python脚本和所在目录对www-data有访问/执行权限：

# 给脚本添加执行权限
chmod +x /var/www/python_script/main.py
# 更改脚本所属用户组为www-data
chown www-data:www-data /var/www/python_script/main.py
# 确保目录有访问权限
chmod 755 /var/www/python_script

2. 如果Python脚本需要sudo权限，通过sudoers配置允许www-data无密码执行：

sudo visudo
# 添加以下行（替换为实际脚本路径）
www-data ALL=(ALL) NOPASSWD: /usr/bin/python3 /var/www/python_script/main.py

此时PHP中的命令需改为：

$command = "sudo $pythonPath $scriptPath $runTime $repeats $performFWUpd $systemType $phoneA $phoneB";

4. 调试验证 #

1. 打开浏览器开发者工具（F12），切换到Network标签，点击按钮后查看Ajax请求是否发送，状态码是否为200。
2. 查看Console标签的日志，确认请求成功/错误信息。
3. 用Postman或curl手动POST参数到callScript.php，验证PHP脚本是否能正确执行Python脚本。

内容的提问来源于stack exchange，提问作者Dandys