本文介绍一种规避 php 默认 post 解析限制、安全高效传输 json + 二进制数据的方案：改用 multipart/form-data 格式，分离结构化数据与文件流，彻底避免 php://input 解析冲突和“input variables exceeded”警告。
在 Node.js 与 PHP 的跨语言 API 交互中，直接拼接 JSON 字符串与原始二进制数据（如通过 \n 分隔）虽逻辑简洁，但存在严重隐患：PHP 在接收到 application/x-www-form-urlencoded 或无明确 Content-Type 的 POST 请求时，会尝试自动解析全部 php://input 流为 $_POST 和 $_FILES，当二进制内容被误判为表单变量或超长键名时，极易触发 Unknown: Input variables exceeded 1000 警告——这并非内存不足，而是 PHP 内部变量解析器的硬性限制（由 max_input_vars 配置控制），且无法通过增大该值根本解决。
推荐方案：使用标准 multipart/form-data 表单上传
该方式完全符合 HTTP 规范，由浏览器和主流 HTTP 客户端原生支持，PHP 会自动将非文件字段存入 $_POST，文件字段存入 $_FILES，无需手动解析边界或截断，既安全又高效。
✅ Node.js 端（使用 axios + form-data）：
立即学习“PHP免费学习笔记（深入）”；
const FormData = require('form-data');
const fs = require('fs');
// 构建表单数据
const formData = new FormData();
formData.append('json', JSON.stringify(msg)); // 结构化元数据
if (msg.binary instanceof Buffer || msg.binary?.path) {
// 若 binary 是 Buffer，需先写入临时文件；若已是文件路径，直接读取流
const fileStream = msg.binary.path
? fs.createReadStream(msg.binary.path)
: fs.createWriteStream('/tmp/upload.bin').end(msg.binary);
formData.append('file', fileStream, { filename: 'data.bin' });
} else if (msg.binary) {
formData.append('file', msg.binary); // 直接附加 Buffer（部分 form-data 版本支持）
}
// 发送请求（注意：axios 会自动设置 boundary，勿手动指定 Content-Type）
await axios.post(url, formData, {
headers: formData.getHeaders(), // 自动包含 'Content-Type: multipart/form-data; boundary=...'
});✅ PHP 端（简洁健壮的接收逻辑）：
<?php
// 1. 解析 JSON 元数据
if (!isset($_POST['json'])) {
http_response_code(400);
die('Missing json field');
}
$jsonData = json_decode($_POST['json'], true);
if (json_last_error() !== JSON_ERROR_NONE) {
http_response_code(400);
die('Invalid JSON in "json" field');
}
// 2. 处理上传的二进制文件
if (!isset($_FILES['file']) || $_FILES['file']['error'] !== UPLOAD_ERR_OK) {
http_response_code(400);
die('File upload failed');
}
$uploadDir = __DIR__ . '/uploads/';
if (!is_dir($uploadDir)) mkdir($uploadDir, 0755, true);
$uploadPath = $uploadDir . basename($_FILES['file']['name']);
if (move_uploaded_file($_FILES['file']['tmp_name'], $uploadPath)) {
// 成功：$jsonData 包含原始消息，$uploadPath 指向保存的二进制文件
echo json_encode(['status' => 'success', 'data' => $jsonData, 'file' => $uploadPath]);
} else {
http_response_code(500);
die('Failed to save uploaded file');
}⚠️ 关键注意事项：
- 不要手动设置 Content-Type 头（如 "multipart/form-data"），必须让 formData.getHeaders() 提供带 boundary 的完整头，否则 PHP 无法识别分段；
- Node.js 中 fs.createReadStream() 是流式传输，内存友好；避免将大文件整个读入 Buffer 再传；
- PHP 端务必校验 $_FILES['file']['error']，防止上传中断或客户端篡改；
- 生产环境需配置 upload_max_filesize、post_max_size 和 max_execution_time 以支持大文件；
- 如需更高性能或流式处理（如视频分片），可考虑基于 raw POST + 自定义协议，但需自行实现边界解析与安全性校验，复杂度显著上升。
综上，采用 multipart/form-data 是兼顾兼容性、安全性与可维护性的最佳实践，彻底绕过 PHP 的 POST 变量解析陷阱，让 JSON 与二进制各司其职，是 Node.js ↔ PHP 二进制通信的标准解法。
