ThinkPHP 文件扩展名白名单校验应使用 ext 规则(非 fileExt),但仅校验后缀不安全,必须配合 MIME 类型和文件头校验;ext 对双扩展名无效,且模型验证不直接支持 File 对象,需在控制器提取文件名后传入。

ThinkPHP 模型字段怎么加文件扩展名白名单校验
直接在模型的 validate 规则里加 fileExt 验证规则,但注意:它只校验扩展名字符串,不读文件头、不防伪造,必须配合服务端 MIME 类型二次校验。
常见错误是只写 ['fileExt' => 'jpg,png,gif'] 就以为安全了——用户改个 xxx.jpg.php 也能过,因为 fileExt 默认只取最后一个点后的部分。
- 用
ext而非fileExt(后者是旧版别名,新版推荐ext) - 扩展名全部小写,且用英文逗号分隔,不能有空格:
['ext' => 'pdf,docx,xlsx'] - 若字段是
file类型上传控件传来的,验证器会自动从$_FILES中提取原始文件名;如果是字符串路径(比如数据库存的旧路径),ext规则不生效 - ThinkPHP 6.1+ 的
ext验证默认调用pathinfo($filename, PATHINFO_EXTENSION),对a.b.c.png返回png,但对a.php.jpg也返回jpg——所以它防不住“双扩展名绕过”
上传前怎么真正限制文件类型(不止看后缀)
仅靠模型验证不够,必须在接收上传时立刻做 MIME 类型 + 文件头校验。ThinkPHP 自带的 think\File 对象提供 getMime() 和 checkImg() 等方法,但 getMime() 依赖 finfo_open,线上环境可能被禁用。
典型错误现象:前端改个 Content-Type: image/jpeg,后端没校验就保存,结果上传了 PHP 文件。
- 用
$file->validate(['size' => 2097152, 'ext' => 'jpg,png,gif', 'mime' => 'image/jpeg,image/png,image/gif']),其中mime是真实 MIME 校验,比ext更可靠 -
mime参数值必须和finfo返回的完全一致(如image/jpeg不等于image/jpg),建议打印$file->getMime()调试一次 - 若服务器禁用
finfo,可手动读文件头判断:jpg 开头是\xFF\xD8\xFF,png 是\x89PNG\r\n\x1A\n,这类校验要自己写逻辑,不能只信$_FILES['type'] - ThinkPHP 6 的
UploadFile配置中,auto_check_mime默认为true,但仅当finfo可用时才生效,否则静默跳过——这点容易被忽略
为什么模型验证里的 ext 规则有时不触发
因为 ThinkPHP 模型验证默认只对传入的字段值做校验,而上传文件对象(think\File 实例)不是字符串,不会进 ext 规则。只有你把文件名单独作为字符串字段传给模型时,ext 才起作用。
常见错误场景:表单提交时,file 字段传的是 think\File 对象,但模型验证规则却写在 file_name 字段上,而实际没传这个字段。
- 如果想让模型统一处理,得先在控制器里提取文件名:
$data['ext'] = $file->getOriginalName();,再把这个字段塞进验证数据 - 更合理做法是:上传逻辑和模型验证分离——上传校验放控制器或服务类,模型只管业务字段(如
file_path,file_size) - 注意
file->getOriginalName()返回的是浏览器传来的原始名,可能含路径(IE 会传C:\fakepath\xxx.jpg),要用basename()清洗 - ThinkPHP 的
Validate类对File对象无内置支持,强行传进去会导致ext规则跳过,不报错也不提示
白名单配置写在哪最不容易漏掉
硬编码在控制器或验证器里,上线后改个格式就得发版;写在配置文件里最稳,而且能按模块区分。
容易踩的坑是多人协作时,上传逻辑散落在不同控制器,白名单各自定义,后期维护成本高、容易不一致。
- 在
config/filesystem.php或新建config/upload.php里定义:'allow_ext' => ['image' => 'jpg,jpeg,png,gif', 'doc' => 'pdf,doc,docx'] - 控制器里统一读配置:
config('upload.allow_ext.image'),避免魔法字符串 - 如果用多文件上传(
input type="file" multiple),$files是数组,需遍历每个$file单独调用validate(),不能一次性传整个数组给验证器 - CLI 环境下上传逻辑可能走不通(比如命令行生成报告附图),此时
finfo常不可用,白名单配置得预留 fallback 机制,比如只校验扩展名 + 日志告警
文件类型校验真正的复杂点不在规则怎么写,而在“谁负责哪一层校验”——前端提示、上传中间件、模型验证、存储前扫描,这四层缺一不可,但最容易被砍掉的是存储前扫描(比如用 OSS 时忘了配回调校验)。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










