Webman中需用$request->file('images')获取多图上传数组，而非直接访问$_FILES；必须检查$file->isValid()、过滤扩展名、创建目标目录并用moveTo()安全保存。
Webman 中如何接收多图上传的 $_FILES 数据
Webman 默认不自动解析 $_FILES 为对象，直接用 $request->file() 才能拿到上传文件实例。如果你在控制器里写 $_FILES['images'] 并试图遍历，大概率会得到空数组或结构错乱——因为 Webman 的请求生命周期绕过了 PHP 原生的全局变量填充逻辑（尤其在 Swoole 环境下）。
正确做法是用框架封装的 file() 方法，并注意多文件时的返回结构变化：
- 单文件：返回一个
UploadFile实例 - 多文件（
）：返回UploadFile实例数组 - 若用
name="images"（无[]）但加了multiple，Swoole 会只取第一个文件，必须带方括号才能批量获取
示例：
// 控制器方法中
$files = $request->file('images');
if (!$files) {
return json(['code' => 400, 'msg' => '未检测到上传文件']);
}
// $files 是数组，即使只传一个也要按数组处理
foreach ($files as $file) {
if (!$file->isValid()) {
return json(['code' => 400, 'msg' => '文件无效：' . $file->getError()]);
}
}
设置单文件大小限制和总上传体积上限
Webman 的上传限制分两层：PHP 层级的 upload_max_filesize 和 post_max_size 是硬门槛；Webman 自身的 $file->getSize() 只能做软校验，无法阻止超大请求体进入内存。
所以必须双管齐下：
- 修改
php.ini：确保upload_max_filesize = 10M、post_max_size = 20M（后者需 ≥ 前者 × 文件数 + 表单其他字段体积） - 在代码中逐个检查：
$file->getSize() > 10 * 1024 * 1024，避免用户绕过前端限制 - 若需限制“所有图片总大小 ≤ 30MB”，需手动累加：
$totalSize = array_sum(array_map(fn($f) => $f->getSize(), $files));
注意：Swoole 模式下，超大的 post_max_size 会导致 worker 进程内存飙升，建议单文件别超过 20MB，总上传量控制在 50MB 内较稳妥。
moveTo() 失败的常见原因和路径安全写法
调用 $file->moveTo($path) 报错 “failed to open stream: No such file or directory” 很常见，本质是目标目录不存在或权限不足，而不是文件本身问题。
安全写法要点：
- 目标路径必须是绝对路径，用
runtime_path() . '/uploads/'而不是./uploads/ - 先创建目录：
is_dir($dir) || mkdir($dir, 0755, true)，true表示递归创建 - 不要直接拼接原始文件名：
$file->getClientFilename()可能含路径遍历字符（如../../etc/passwd），应过滤后缀并生成唯一名：$ext = pathinfo($file->getClientFilename(), PATHINFO_EXTENSION); $newName = uniqid() . '.' . strtolower($ext); - 显式检查扩展名白名单：
in_array(strtolower($ext), ['jpg', 'jpeg', 'png', 'gif'])，不能只靠 MIME 类型（易伪造）
示例：
$uploadDir = runtime_path() . '/uploads/';
if (!is_dir($uploadDir)) {
mkdir($uploadDir, 0755, true);
}
$ext = strtolower(pathinfo($file->getClientFilename(), PATHINFO_EXTENSION));
if (!in_array($ext, ['jpg', 'jpeg', 'png', 'gif'])) {
throw new \Exception('不支持的图片格式');
}
$newPath = $uploadDir . uniqid() . '.' . $ext;
$file->moveTo($newPath);
Swoole 环境下上传进度与超时问题
Webman 基于 Swoole，没有传统 FPM 的 max_execution_time，但有 swoole.http_server 的 upload_tmp_dir 和 request_timeout 配置影响上传体验。
关键点：
- 大文件上传容易触发
request_timeout（默认 60 秒），需在config/server.php中调大：'setting' => ['request_timeout' => 300] - Swoole 不支持原生 PHP 的
session.upload_progress，如需进度条，得改用前端分片上传（如web-upload库）+ 后端合并逻辑 - 临时文件默认存于
/tmp，高并发上传可能占满磁盘，建议通过swoole.http_server的upload_tmp_dir指向独立高速盘 - 上传完成后，
$file->getRealPath()返回的是临时路径，moveTo()后该临时文件即被删除，不可再读
上传不是“丢给框架就完事”的操作，路径、权限、超时、并发、安全过滤，每一步漏掉都可能在线上突然失效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
