Moodle环境下PHP如何通过HTTP将文件句柄发送至Node.js应用

原代码存在的核心问题 #

• 直接传递文件句柄无效：cURL的multipart/form-data上传不支持直接将文件句柄作为contents值传入，无法正确读取文件内容。
• 手动设置请求头错误：当用数组作为CURLOPT_POSTFIELDS参数时，cURL会自动生成包含boundary的multipart/form-data请求头，手动设置会覆盖该头，导致请求格式损坏，Node端无法解析。
• 未释放资源：使用完文件句柄后未关闭，可能造成资源泄漏。

修正后的代码 #

foreach ($files as $file) {
    // 仅处理有合法MIME类型的文件
    if ($mimetype = $file->get_mimetype()) {
        $fh = $file->get_content_file_handle();
        if (!$fh) {
            continue; // 跳过无法获取句柄的文件
        }
        
        // 从文件句柄读取全部内容
        $fileContent = stream_get_contents($fh);
        fclose($fh); // 立即关闭句柄，释放资源
        
        $postdata[] = [
            'name' => 'files[]',
            'contents' => $fileContent,
            'filename' => $file->get_filename(),
            'headers' => [
                'Content-Type' => $mimetype,
            ],
        ];
    }
}

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, '你的Node.js接口地址');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $postdata);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

// 可选：开启错误捕获，方便调试
curl_setopt($curl, CURLOPT_FAILONERROR, true);

try {
    $response = curl_exec($curl);
    if (curl_errno($curl)) {
        throw new Exception(curl_error($curl));
    }
    // 处理Node端返回的响应
    echo $response;
} catch (Exception $e) {
    echo '请求失败: ' . $e->getMessage();
} finally {
    curl_close($curl);
}

关键说明 #

1. 文件内容读取：用stream_get_contents()从文件句柄中读取全部内容，这是无文件路径场景下的标准处理方式。如果文件过大，可考虑分块上传，但多数场景下一次性读取足够使用。
2. 请求头自动处理：删除手动设置的Content-Type，让cURL自动生成包含boundary的合法请求头，确保Node端能正确解析multipart数据。
3. 错误与资源管理：添加错误捕获逻辑，同时在读取后立即关闭文件句柄，避免资源泄漏。

Node端对接示例（Express框架） #

如果使用Express接收文件，可借助multer中间件快速处理：

const express = require('express');
const multer = require('multer');
const app = express();
const upload = multer({ dest: 'uploads/' }); // 文件临时存储目录

app.post('/upload', upload.array('files'), (req, res) => {
    // req.files 为上传的文件数组，包含文件名、MIME类型、存储路径等信息
    console.log('收到文件:', req.files);
    res.json({ success: true, files: req.files });
});

app.listen(3000, () => {
    console.log('服务运行在3000端口');
});

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