Laravel中如何让finfo识别非逗号分隔的CSV文件通过mimes:csv验证？

我有两个文件，正尝试通过cURL将它们上传至某个接口。

file1.csv #

header1,header2
row1_value1,row1_value2
row2_value1,row2_value2

file2.csv #

header1;header2
row1_value1;row1_value2
row2_value1;row2_value2

只有file1.csv能通过mimes:csv验证规则，上传命令如下：

curl -F "file=@file1.csv" -X POST http://host/api/endpoint 

我已定位到验证失败的根源：Symfony的FileinfoMimeTypeGuesser中执行了这段代码：

(new \finfo(\FILEINFO_MIME_TYPE, null))->file($path)

是否可以让finfo将使用非标准分隔符（如分号;）的CSV文件识别为CSV类型，让两个示例文件都能通过Laravel的'mimes:csv'验证？

我不了解finfo的底层工作原理，但它有一个可选的$magic_database参数可以传入。

1. 自定义验证规则（推荐） #

直接修改finfo的魔法数据库成本高且通用性差，更务实的方式是绕过默认检测逻辑，自定义CSV验证规则：

创建CsvFile验证类：

<?php

namespace App\Rules;

use Illuminate\Contracts\Validation\Rule;

class CsvFile implements Rule
{
    public function passes($attribute, $value)
    {
        // 先校验文件后缀
        if ($value->getClientOriginalExtension() !== 'csv') {
            return false;
        }

        // 读取首行判断是否包含逗号或分号分隔符
        $handle = fopen($value->getPathname(), 'r');
        $firstLine = fgets($handle);
        fclose($handle);

        return strpos($firstLine, ',') !== false || strpos($firstLine, ';') !== false;
    }

    public function message()
    {
        return 'The :attribute must be a valid CSV file (supports comma or semicolon delimiters).';
    }
}

在验证逻辑中替换原有的mimes:csv：

$request->validate([
    'file' => ['required', new CsvFile],
]);

2. 扩展MIME类型猜测器 #

如果希望保留Laravel默认的验证语法，可以扩展Symfony的MIME猜测器：

创建自定义猜测器类：

<?php

namespace App\Mime;

use Symfony\Component\HttpFoundation\File\MimeType\MimeTypeGuesserInterface;

class CustomCsvMimeTypeGuesser implements MimeTypeGuesserInterface
{
    public function guess($path)
    {
        // 后缀为csv直接返回text/csv
        if (pathinfo($path, PATHINFO_EXTENSION) === 'csv') {
            return 'text/csv';
        }

        // 读取内容判断分隔符
        $handle = fopen($path, 'r');
        $firstLine = fgets($handle);
        fclose($handle);

        if (strpos($firstLine, ',') !== false || strpos($firstLine, ';') !== false) {
            return 'text/csv';
        }

        return null;
    }
}

在AppServiceProvider的boot方法中注册：

use Symfony\Component\HttpFoundation\File\MimeType\MimeTypeGuesser;
use App\Mime\CustomCsvMimeTypeGuesser;

public function boot()
{
    $guesser = MimeTypeGuesser::getInstance();
    $guesser->register(new CustomCsvMimeTypeGuesser());
}

3. 修改finfo魔法数据库（不推荐） #

若一定要通过finfo识别，需修改系统魔法文件（通常路径为/usr/share/misc/magic），添加分号CSV的检测规则：

0       string  header1;header2     text/csv
>0      regex   ^[A-Za-z0-9_]+;[A-Za-z0-9_]+$  text/csv

但此方法需要服务器权限，系统更新可能覆盖修改，仅适合测试环境。

4. 后缀+内容双重校验（简单方案） #

如果业务场景允许，可直接校验后缀并额外检查内容：

$request->validate([
    'file' => 'required|file|mimes:csv',
], [
    'file.mimes' => '请上传有效的CSV文件（支持逗号或分号分隔）',
]);

// 额外校验内容
$file = $request->file('file');
$content = file_get_contents($file->getPathname());
if (!str_contains($content, ',') && !str_contains($content, ';')) {
    return back()->withErrors(['file' => 'CSV文件内容格式不正确']);
}

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