必须先严格检查 $_FILES'file' === UPLOAD_ERR_OK，否则文件未上传成功，后续校验无意义；需区分错误码4和1并针对性提示；禁用不可信的type字段，改用finfo_open()检测MIME；扩展名仅作辅助；move_uploaded_file()失败主因是权限、路径构造及Web目录安全配置。
如何检查 $_FILES 的 error 值是否为 UPLOAD_ERR_OK
这是整个验证流程的第一道关卡，不是可选步骤，而是必须前置判断。如果 $_FILES['file']['error'] !== UPLOAD_ERR_OK，后续所有校验都无意义——文件根本没进临时目录。
常见错误现象：直接跳过 error 检查，导致 move_uploaded_file() 对一个无效 tmp_name 操作，返回 false 但不报错，用户看到“上传成功”实际却没文件。
- 必须用
===严格比较，避免0 == '0'这类松散判断误判字符串型错误码 -
UPLOAD_ERR_NO_FILE（4）和UPLOAD_ERR_INI_SIZE（1）需区分处理：前者是前端没选文件，后者是 PHP 配置限制，应提示用户“文件太大，请压缩后重试”而非“请选择文件” - 表单中若含
<input type="hidden" name="MAX_FILE_SIZE" value="5242880">，其值仅作客户端提示，$_FILES['file']['error']仍可能为UPLOAD_ERR_FORM_SIZE（2），必须检查
为什么不能只信 $_FILES['file']['type']？
这个字段由浏览器提供，完全不可信。攻击者可轻易伪造 Content-Type: image/jpeg，而实际上传的是 PHP WebShell 文件。
真正有效的 MIME 类型检测必须用服务器端工具，例如 finfo_open()：
$finfo = finfo_open(FILEINFO_MIME_TYPE); $mimeType = finfo_file($finfo, $_FILES['file']['tmp_name']); finfo_close($finfo);
常见陷阱：未开启 fileinfo 扩展（PHP 默认可能关闭），或传入路径错误（必须是 tmp_name，不是原始 name）。
- 白名单应基于
$mimeType，如in_array($mimeType, ['image/jpeg', 'image/png', 'application/pdf']) - 扩展名（
pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION)）只能作为辅助，绝不能单独用于拦截 - 对 PDF、Office 等复合格式，还需额外检查文件头（magic bytes），否则仍可能绕过
move_uploaded_file() 失败的三个高频原因
即使 error === UPLOAD_ERR_OK 且 MIME 校验通过，move_uploaded_file() 仍可能静默失败。它只返回 bool，不抛异常，也不说明原因。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
最常被忽略的是目标目录权限与路径构造问题：
- 目标目录（如
uploads/）必须存在且 PHP 进程有写权限；mkdir($dir, 0755, true)要加true参数递归创建父级 - 拼接路径时勿直接拼
$_FILES['file']['name']，防止目录遍历（如文件名含../../etc/passwd）；应强制用basename()或更安全的uniqid() . '.' . $ext - 目标路径不能是 Web 可访问的根目录下裸文件（如
uploads/shell.php），应存到 Web 根目录外，或确保该目录禁用 PHP 解析（Nginx 中配置location ~ \.php$ { deny all; }）
Echo 框架里怎么接入这些验证逻辑？
Echo 本身不内置文件校验，它只负责路由和中间件。你需要把上述 PHP 原生验证封装成自定义中间件或在 handler 内手动调用。
典型做法是在路由 handler 开头插入验证块，而非依赖框架自动解析：
e.POST("/upload", func(c echo.Context) error {
file, err := c.FormFile("file")
if err != nil {
return echo.NewHTTPError(http.StatusBadRequest, "no file uploaded")
}
src, err := file.Open()
if err != nil {
return err
}
defer src.Close()
// 此处插入 finfo 检测、大小判断、move_uploaded_file 等逻辑
// 注意：c.FormFile() 返回的是 *multipart.FileHeader，不含 error 字段，需自行读取 tmp_name 并用原生 $_FILES 方式校验
})
关键点：Echo 的 c.FormFile() 会触发文件解析，但不暴露原始 $_FILES 数组，所以你得用 c.Request().MultipartForm 或直接操作 $_FILES 全局变量——后者更可控，也更贴近底层验证需求。
真正复杂的地方在于，MIME 检测、文件头扫描、权限检查、路径净化这几步必须串行执行，且任一环节失败都要立即中断并返回明确错误，而不是堆砌一堆 if-else 最后才报错。
