讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

Laravel框架内置的文件验证规则底层是如何校验类型的

小明酱_1677

小明酱_1677

发布时间:2026-09-18 09:22:26

|

540人浏览过

|

来源于php中文网

原创

file和image规则仅校验UploadedFile实例及error状态,image额外调用getimagesize();mimes依赖fileinfo扩展与魔数检测;数组上传需用files.*规则逐项校验;自定义非标MIME应基于扩展名而非finfo。

laravel框架内置的文件验证规则底层是如何校验类型的

file 和 image 规则本质是检查 UploadedFile 实例

这两个规则不会读取文件内容,而是依赖 Illuminate\Http\UploadedFile 对象的元信息。当 Laravel 接收到 multipart/form-data 请求后,会为每个上传项自动实例化该类——它封装了 $_FILES 数组中的 tmp_name、name、size、error 等字段。

file 规则只做两件事:确认值是 UploadedFile 实例且 error === UPLOAD_ERR_OK;image 在此基础上额外调用 getimagesize() 函数尝试解析头信息。这意味着:

  • 即使伪造 .jpg 扩展名,但文件内容不是合法图像,image 会失败
  • 若服务器禁用了 getimagesize()(如 open_basedir 限制),image 可能误报 false negative
  • file 不校验 MIME 或扩展名,仅确保是有效上传项

mimes 规则依赖 fileinfo 扩展 + 魔数检测

mimes 规则底层调用的是 PHP 的 finfo_file(),它读取文件前几百字节(即“魔数”)来推断真实类型,完全忽略客户端传来的 Content-Type 和扩展名。这比仅检查扩展名更安全,但也带来几个硬性前提:

  • 必须启用 PHP fileinfo 扩展(Laravel 启动时会检查,缺失则抛出 RuntimeException)
  • 服务器上 finfo 数据库需包含目标类型(例如 bdoc 不在默认库中,mimes:bdoc 必然失败)
  • 上传文件不能是空文件(finfo_file() 对空文件返回 application/x-empty,不匹配任何白名单)
  • 临时文件路径需可读——如果 upload_tmp_dir 权限错误或磁盘满,finfo_file() 会静默失败并返回 false,导致验证通过但后续 store() 报错

required|file 混用在数组字段上会失效

常见错误是写成 'files' => 'required|array|file'。这里 file 作用于整个数组变量,而数组不是 UploadedFile 实例,必然失败。正确做法是用通配符:

Laravel Cloud
Laravel Cloud

Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。

下载
  • 'files.*' => 'required|file|mimes:pdf,jpg':逐个校验每个数组元素
  • 'files' => 'required|array|min:1':单独控制数组本身(是否为空、长度等)
  • 不要省略 required|file 在通配符规则里——没有它,files[0] 为 null 时也不会报错

这个细节容易被忽略,因为错误现象是“明明选了文件却提示未上传”,而不是报错信息明确指向规则写法。

自定义 MIME 校验必须绕过 finfo

当需要支持 bdoc、asice 这类非标格式时,不能靠扩展 finfo 数据库(部署成本高、不可控),而应基于扩展名做轻量判断。此时必须手写 Rule 类,在 passes() 中调用 $value->getClientOriginalExtension(),而非 $value->getMimeType()。

原因很实际:getMimeType() 内部仍走 finfo,而 getClientOriginalExtension() 直接取客户端提交的原始文件名后缀,稳定、快速、不依赖扩展。但要注意它不防伪造——所以仅适用于业务层信任前端(如内网系统)、或配合后续服务端签名验真流程的场景。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

12744

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

7321

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2255

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

4608

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

5334

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

4191

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

6077

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4782

2023.11.13

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

0

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP基础入门课程
PHP基础入门课程

共33课时 | 3.5万人学习

PHP经典实战视频教程
PHP经典实战视频教程

共23课时 | 6.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn