本文旨在解决在node.js环境中通过`execsync`调用`php-cgi`时，php的`$_post`超全局变量无法正确获取post参数的问题。核心在于`php-cgi`处理post数据的方式与get数据不同，它期望post数据通过标准输入（stdin）接收，而非环境变量。教程将详细解释这一机制，并提供正确的代码示例，确保`$_post`能够被准确填充。
理解php-cgi与HTTP请求数据处理
在构建自定义Web服务器（例如使用Node.js）并需要执行PHP脚本时，通常会通过调用php-cgi可执行文件来处理PHP请求。php-cgi是一个CGI（Common Gateway Interface）程序，它依赖于环境变量和标准输入/输出来与Web服务器通信。
对于HTTP GET请求，参数通常附加在URL的查询字符串中。php-cgi通过读取QUERY_STRING环境变量来获取这些参数，并将其填充到PHP的$_GET超全局变量中。因此，设置process.env["QUERY_STRING"] = queryString; 能够使$_GET正常工作。
然而，对于HTTP POST请求，数据通常包含在请求体中，而不是URL中。php-cgi处理POST数据的方式与GET数据截然不同。尽管CONTENT_LENGTH和CONTENT_TYPE这些环境变量对于php-cgi解析POST数据至关重要，但它们仅告知php-cgi请求体的大小和类型，实际的POST数据本身需要通过php-cgi进程的标准输入（stdin）来传递。如果仅仅设置了环境变量而没有将POST数据作为stdin输入，$_POST将保持为空。
问题根源：POST数据未通过stdin传递
原始实现中，虽然设置了CONTENT_LENGTH和CONTENT_TYPE环境变量，但POST参数字符串queryString并没有作为php-cgi进程的实际输入。Node.js的execSync函数默认情况下不会将第三个参数（环境变量对象）中的某个键值对直接作为子进程的stdin。
立即学习“PHP免费学习笔记（深入）”；
// 原始的错误尝试 process.env["CONTENT_LENGTH"] = queryString.length; process.env["CONTENT_TYPE"] = "application/x-www-form-urlencoded"; // ... 其他环境变量 // 这里的queryString只是一个局部变量，没有被传递给php-cgi的stdin content = execSync(phpPath + "php-cgi", process.env);
解决方案：通过input选项传递POST数据
Node.js的child_process.execSync函数提供了一个options对象，其中包含一个input属性，专门用于将数据作为子进程的标准输入。要正确填充$_POST，需要将POST请求体的数据通过此input选项传递给php-cgi。
// 正确的实现方式
const phpPath = './path/to/php/'; // 假设php-cgi的路径
const resource = '/path/to/your/script.php'; // PHP脚本路径
const requestMethod = 'POST'; // 或 'GET'
const queryString = 'param1=value1¶m2=value2'; // GET或POST的参数字符串
// 准备环境变量
let env = {
"GATEWAY_INTERFACE": "CGI/1.1",
"SCRIPT_FILENAME": path.resolve(resource),
"REQUEST_METHOD": requestMethod,
"REDIRECT_STATUS": 200,
// 其他根据需要设置的环境变量
};
let execOptions = { env: env };
let postData = '';
if (requestMethod === 'POST') {
// 对于POST请求，将参数作为stdin输入
postData = queryString; // 假设queryString就是POST请求体
env["CONTENT_LENGTH"] = Buffer.byteLength(postData, 'utf8'); // 使用Buffer获取字节长度
env["CONTENT_TYPE"] = "application/x-www-form-urlencoded"; // 或其他Content-Type
execOptions.input = postData; // 关键：通过input选项传递POST数据
} else if (requestMethod === 'GET') {
// 对于GET请求，将参数作为QUERY_STRING环境变量
env["QUERY_STRING"] = queryString;
}
try {
const content = execSync(phpPath + "php-cgi", execOptions);
console.log(content.toString());
} catch (error) {
console.error("Error executing php-cgi:", error.message);
}在上述代码中，execOptions.input = postData; 是解决问题的关键。它确保了php-cgi能够通过其标准输入接收到POST请求体的数据，从而正确解析并填充$_POST超全局变量。
综合考虑GET和POST请求
在实际应用中，服务器需要能够处理GET和POST两种请求。可以通过检查请求方法来动态地设置环境变量和execSync的选项。
const path = require('path');
const { execSync } = require('child_process');
function executePhpCgi(phpPath, resource, requestMethod, paramsString, contentType = 'application/x-www-form-urlencoded') {
let env = {
"GATEWAY_INTERFACE": "CGI/1.1",
"SCRIPT_FILENAME": path.resolve(resource),
"REQUEST_METHOD": requestMethod,
"REDIRECT_STATUS": 200,
// 根据实际需求添加其他CGI环境变量，例如REMOTE_ADDR, SERVER_NAME等
};
let execOptions = { env: env };
let phpOutput = '';
if (requestMethod === 'POST') {
// 对于POST请求，数据通过stdin传递
const postBuffer = Buffer.from(paramsString, 'utf8');
env["CONTENT_LENGTH"] = postBuffer.byteLength;
env["CONTENT_TYPE"] = contentType;
execOptions.input = postBuffer; // 使用Buffer更安全地处理二进制数据
} else if (requestMethod === 'GET') {
// 对于GET请求，数据通过QUERY_STRING环境变量传递
env["QUERY_STRING"] = paramsString;
} else {
// 其他HTTP方法，例如HEAD, PUT, DELETE等，根据需要处理
console.warn(`Unsupported HTTP method: ${requestMethod}`);
return '';
}
try {
phpOutput = execSync(phpPath + "php-cgi", execOptions).toString();
} catch (error) {
console.error(`Error executing php-cgi for ${requestMethod} ${resource}:`, error.message);
// 捕获错误，例如PHP脚本执行错误或php-cgi找不到
// 可以根据需要抛出或返回错误信息
phpOutput = `PHP execution failed: ${error.stderr ? error.stderr.toString() : error.message}`;
}
return phpOutput;
}
// 示例用法：
// 1. GET请求
const getParams = "name=Alice&age=30";
const getResult = executePhpCgi(
'C:/php/php-8.x.x/', // 替换为你的php-cgi实际路径
'./test_get.php', // 假设存在一个test_get.php文件
'GET',
getParams
);
console.log("GET Request Result:\n", getResult);
// test_get.php 内容示例: <?php print_r($_GET); ?>
// 2. POST请求
const postParams = "product=Laptop&price=1200";
const postResult = executePhpCgi(
'C:/php/php-8.x.x/', // 替换为你的php-cgi实际路径
'./test_post.php', // 假设存在一个test_post.php文件
'POST',
postParams
);
console.log("POST Request Result:\n", postResult);
// test_post.php 内容示例: <?php print_r($_POST); ?>
// 3. POST请求 with JSON
const jsonParams = JSON.stringify({ item: "book", quantity: 2 });
const jsonPostResult = executePhpCgi(
'C:/php/php-8.x.x/', // 替换为你的php-cgi实际路径
'./test_json_post.php', // 假设存在一个test_json_post.php文件
'POST',
jsonParams,
'application/json' // 更改Content-Type
);
console.log("JSON POST Request Result:\n", jsonPostResult);
// test_json_post.php 内容示例: <?php $data = json_decode(file_get_contents('php://input'), true); print_r($data); ?>注意事项与总结
- CONTENT_LENGTH的准确性：CONTENT_LENGTH环境变量必须准确反映POST请求体的字节长度。对于UTF-8编码的字符串，应使用Buffer.byteLength()来获取字节长度，而不是字符串的字符长度。
- CONTENT_TYPE的重要性：CONTENT_TYPE环境变量告诉php-cgi如何解析stdin中的数据。例如，application/x-www-form-urlencoded用于标准的表单提交，application/json用于JSON数据。PHP会根据此类型尝试解析数据，例如，对于application/json，需要手动通过file_get_contents('php://input')来读取原始POST数据并进行JSON解码。
- 错误处理：execSync在子进程返回非零退出码时会抛出错误。务必使用try-catch块来捕获并处理这些错误，以便更好地调试PHP脚本执行中的问题。
- PHP路径：确保phpPath变量指向正确的php-cgi可执行文件路径。
- 安全性：直接执行外部程序存在安全风险。在生产环境中，应仔细验证所有输入，避免命令注入等问题。
通过正确理解php-cgi处理不同HTTP请求数据流的机制，并利用Node.js execSync的input选项，可以有效地在自定义服务器中集成PHP，确保$_POST超全局变量能够被准确地填充。
