PHP Laravel中如何验证上传文件的MIME类型属于任意图像格式

mime_content_type 函数依赖服务器系统内置的MIME映射数据库，绝大多数老旧版本的操作系统默认数据库没有收录HEIC/HEIF格式的MIME映射，所以会将HEIC文件错误识别为通用二进制流 application/octet-stream，导致校验失败。

优先使用PHP原生内置的finfo扩展做文件类型检测，该扩展PHP 5.3及以上版本默认启用，基于文件内容识别类型，准确率远高于mime_content_type，且可以直接匹配image/*大类，不需要手动拆分字符串，不存在重复造轮子的问题，安全性也有官方保障。

基础检测代码 #

// 初始化finfo实例，指定返回MIME类型
$finfo = new Finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($file->getRealPath());

// PHP 8.0+ 直接用str_starts_with匹配image大类
if (str_starts_with($mime, 'image/')) {
    // 合法图片
}

// 低版本PHP兼容写法
if (substr($mime, 0, 6) === 'image/') {
    // 合法图片
}

Laravel框架专属简化方案 #

你的代码使用了Laravel的请求文件处理和字符串辅助函数，可以直接用Laravel自带的验证规则实现，不需要手动写检测逻辑：
在控制器中先做表单验证即可：

$request->validate([
    'photos.*' => 'mimetypes:image/*',
    // 也可以直接用image规则，手动扩展后可支持HEIC
]);

如果Laravel默认的image规则不识别HEIC，可以在AppServiceProvider的boot方法中扩展验证规则：

Validator::extend('image', function ($attribute, $value, $parameters, $validator) {
    $finfo = new Finfo(FILEINFO_MIME_TYPE);
    $mime = $finfo->file($value->getRealPath());
    return str_starts_with($mime, 'image/');
});

极端环境兜底兼容 #

如果部分服务器环境的finfo还是无法正确识别HEIC，可以新增文件头校验作为兜底逻辑，HEIC/HEIF文件的前12个字节包含固定标识：

function isHeicFile(string $filePath): bool
{
    $handle = fopen($filePath, 'rb');
    if (!$handle) return false;
    $header = fread($handle, 12);
    fclose($handle);
    $heicSignatures = ['ftypheic', 'ftypheix', 'ftypheif', 'ftypheim', 'ftyphevc', 'ftyphevx'];
    return in_array(substr($header, 4, 8), $heicSignatures);
}

$finfo = new Finfo(FILEINFO_MIME_TYPE);
foreach ($request->allFiles() as $key => $files)
    foreach ($files as $file) {
        $mime = $finfo->file($file->getRealPath());
        $isValidImage = substr($mime, 0, 6) === 'image/' || isHeicFile($file->getRealPath());
        if ($isValidImage) {
            // 上传到CDN服务器
            $response->attach('photos[' . Str::random(20) . ']', file_get_contents($file->getRealPath()), Str::random(20) . '.' . $file->getClientOriginalExtension());
        } else {
            return back()->withErrors(['有一个或多个文件不符合我们CDN平台的支持格式，请尝试关闭实况照片功能后重试。']);
        }
    }

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