PHP调用CGI程序时环境变量未传递问题求助

你踩的这个坑其实挺常见的——用apache_setenv传变量给CGI程序根本行不通，因为两者的环境完全是两码事！我来给你拆解清楚问题，再给你靠谱的解决方案：

问题出在哪？ #

1. apache_setenv的作用范围不对：这个函数是给Apache服务器本身或者后续的Apache处理环节设置变量的，不会同步到PHP进程的环境变量（也就是$_ENV）里。而shell_exec启动的是一个独立的系统子进程，它只会继承PHP进程本身的环境变量，所以你用apache_setenv设的变量，子进程根本看不到。
2. 你漏掉了CGI的核心机制：C语言写的CGI程序不是直接读你传的零散变量，它依赖标准CGI环境变量来工作：
   • GET请求：参数存在QUERY_STRING环境变量里，同时需要REQUEST_METHOD=GET
   • POST请求：参数是从标准输入（stdin）读取的，还需要设置REQUEST_METHOD=POST、CONTENT_TYPE、CONTENT_LENGTH等变量

正确的实现方法 #

根据请求方法的不同，我们需要分别处理：

情况1：处理GET请求 #

直接把GET参数拼接成QUERY_STRING，用putenv设置到PHP环境中，这样子进程就能继承到这些变量：

// 获取当前请求方法
$requestMethod = $_SERVER['REQUEST_METHOD'];

// 必须设置REQUEST_METHOD，CGI程序靠它判断请求类型
putenv("REQUEST_METHOD=$requestMethod");

if ($requestMethod === 'GET') {
    // 把GET参数拼接成标准的query string格式
    $queryString = http_build_query($_GET);
    putenv("QUERY_STRING=$queryString");
    
    // 用绝对路径更稳妥，避免相对路径找不到文件的问题
    $out = shell_exec('/var/www/html/cgi-bin/Mycgi.cgi');
    
    // 这里修改你的输出
    // $out = str_replace('old', 'new', $out);
    
    echo $out;
}

情况2：处理POST请求 #

POST请求的参数不是存在环境变量里，而是需要通过标准输入传给CGI程序，这时候shell_exec就不够用了，得用proc_open来处理stdin/stdout的交互：

$requestMethod = $_SERVER['REQUEST_METHOD'];
putenv("REQUEST_METHOD=$requestMethod");

if ($requestMethod === 'POST') {
    // 获取POST原始数据和相关头信息
    $postData = file_get_contents('php://input');
    $contentType = $_SERVER['CONTENT_TYPE'] ?? 'application/x-www-form-urlencoded';
    $contentLength = $_SERVER['CONTENT_LENGTH'] ?? strlen($postData);
    
    // 设置CGI需要的环境变量
    putenv("CONTENT_TYPE=$contentType");
    putenv("CONTENT_LENGTH=$contentLength");
    
    // 定义进程的输入输出管道
    $descriptorspec = [
        0 => ['pipe', 'r'], // 标准输入，传给CGI程序
        1 => ['pipe', 'w'], // 标准输出，捕获CGI的输出
        2 => ['pipe', 'w']  // 标准错误，用来调试
    ];
    
    // 启动CGI进程（同样建议用绝对路径）
    $process = proc_open('/var/www/html/cgi-bin/Mycgi.cgi', $descriptorspec, $pipes);
    
    if (is_resource($process)) {
        // 把POST数据写入CGI的标准输入
        fwrite($pipes[0], $postData);
        fclose($pipes[0]);
        
        // 读取CGI的输出
        $out = stream_get_contents($pipes[1]);
        fclose($pipes[1]);
        
        // 读取错误信息（调试的时候可以打开）
        // $error = stream_get_contents($pipes[2]);
        // fclose($pipes[2]);
        
        // 关闭进程
        proc_close($process);
        
        // 修改输出后返回给用户
        // $out = modifyMyOutput($out);
        echo $out;
    } else {
        http_response_code(500);
        echo 'Failed to start CGI process';
    }
}

额外注意事项 #

• 用绝对路径：不要依赖相对路径，确保PHP能找到你的CGI程序，比如/var/www/html/cgi-bin/Mycgi.cgi
• 权限问题：PHP运行的用户（通常是www-data）需要有CGI程序的执行权限，用chmod +x Mycgi.cgi给程序加执行权限，同时确保目录权限正确
• 调试技巧：如果还是不行，可以把CGI程序的标准错误输出读出来（上面代码里注释的$error部分），看看CGI程序报了什么错，方便定位问题

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