如何在Laravel中为上传文件添加有效的验证规则

排查出的常见原因 #

• 缺少file基础验证规则：Laravel的mimes验证仅针对文件类型字段生效，必须先声明file规则指定该字段为上传文件，否则验证逻辑不会识别该字段为文件类型，导致规则不生效
• 未配置文件字段的错误提示：现有Blade模板中没有添加file字段对应的错误输出代码，即便验证失败触发重定向，也看不到错误提示，会误判为验证未生效
• 验证规则存在错误：规则中写入了不必要的大写PNG（Laravel的mimes规则不区分大小写），且存在扩展名拼写错误（xsl应为xls，对应Excel表格扩展名）
• PHP上传配置限制：如果上传文件超过php.ini中配置的upload_max_filesize或post_max_size上限，请求会被截断，后端无法获取到上传文件，验证逻辑自然不触发

修复方案 #

1. 修改控制器验证规则 #

调整file字段的验证规则如下：

public function store( Product $product, Request $request)
{
    $this->validate($request, [
        'info' => ['required'],
        'min' =>['required'],
        'max' => ['required'],
        // 新增file规则，修正扩展名错误，可选加max限制文件大小（单位KB，10240即10M）
        'file' => ['nullable', 'file', 'mimes:jpg,jpeg,png,doc,docx,pdf,xls,xlsx', 'max:10240'],
    ]);

    // 后续业务逻辑不变
}

2. Blade模板添加文件错误提示 #

在文件上传模块的div块下方添加错误输出代码，验证失败时即可看到提示：

<div class="flex w-full h-20 items-center justify-center bg-grey-lighter">
    <!-- 原有文件上传代码不变 -->
</div>
<!-- 新增错误提示 -->
@error('file')
<p class="text-red-500 text-xs italic mt-2 text-center">{{$message}}</p>
@enderror

3. 校验PHP上传配置 #

如果需要上传大文件，编辑php.ini文件调整相关参数，修改后重启PHP服务即可生效：

upload_max_filesize = 20M
post_max_size = 20M

可选优化点 #

现有文件名生成逻辑存在重复后缀问题：time().'.'.$order_file->getClientOriginalName()中getClientOriginalName()已经包含原文件后缀，拼接后会生成时间戳.原文件名.后缀的格式，建议改为：

// 用下划线拼接时间戳和原文件名，避免重复后缀
$file_name = time().'_'.$order_file->getClientOriginalName();

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