PHP7.4文件类型检测代码示例-php教程-PHP中文网

php 7.4 中检测文件真实类型最可靠方式是使用 finfo_open()（基于 libmagic），通过读取文件头（magic bytes）判断 mime 类型，推荐用 finfo_file() 或 finfo_buffer()，禁用扩展名和 mime_content_type() 等不安全方法。

php7.4文件类型检测代码示例

PHP 7.4 中检测文件类型，**不依赖扩展名，而是通过读取文件头（magic bytes）判断真实类型**，最可靠的方式是使用 finfo_open() 函数（基于 libmagic 库）。该函数在 PHP 7.4 中默认启用且稳定，无需额外安装扩展（只要编译时启用了 fileinfo）。

✅ 使用 finfo 检测 MIME 类型（推荐）

这是 PHP 官方推荐、安全且准确的方法。它读取文件前几百字节，比仅检查后缀更可信。

确保 fileinfo 扩展已启用（PHP 7.4 默认开启，可通过 extension_loaded('fileinfo') 验证）
用 FILEINFO_MIME_TYPE 获取类型（如 image/jpeg），或 FILEINFO_MIME 获取带编码的完整 MIME 字符串
注意：finfo_file() 接收的是文件路径，不是文件内容；若只有二进制数据（如上传临时内容），需先写入临时文件或使用 finfo_buffer()

示例代码：

<?php function detectMimeType(string $filePath): ?string
{
    if (!is_readable($filePath)) {
        return null;
    }

    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    if ($finfo === false) {
        return null;
    }

    $mimeType = finfo_file($finfo, $filePath);
    finfo_close($finfo);

    return $mimeType ?: null;
}

// 使用
$mime = detectMimeType('/path/to/uploaded.jpg');
var_dump($mime); // string(10) "image/jpeg"
?>

✅ 检测上传文件的真实类型（结合 $_FILES）

处理表单上传时，不能信任 $_FILES['file']['type']（前端可伪造），必须服务端校验。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

优先用 finfo_buffer() 直接分析 $_FILES['file']['tmp_name'] 的内容，避免磁盘 I/O
读取临时文件内容时建议限制大小（如前 4096 字节足够识别多数类型）
对空文件或读取失败做防御性处理

示例代码：

<?php function getUploadedFileType(array $uploadedFile): ?string
{
    if (empty($uploadedFile['tmp_name']) || !is_uploaded_file($uploadedFile['tmp_name'])) {
        return null;
    }

    $content = file_get_contents($uploadedFile['tmp_name'], false, null, 0, 4096);
    if ($content === false) {
        return null;
    }

    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    if (!$finfo) {
        return null;
    }

    $type = finfo_buffer($finfo, $content);
    finfo_close($finfo);

    return $type ?: null;
}

// 在接收上传后调用
if ($_FILES['avatar']['error'] === UPLOAD_ERR_OK) {
    $realType = getUploadedFileType($_FILES['avatar']);
    if (in_array($realType, ['image/png', 'image/jpeg', 'image/gif'], true)) {
        // 允许保存
    } else {
        throw new Exception('不支持的文件类型');
    }
}
?>

⚠️ 不推荐的方式（兼容性或安全性差）

以下方法在 PHP 7.4 中应避免：

getimagesize()：仅适用于图片，且对非图文件可能报错或返回 false，不能作为通用检测手段
仅检查扩展名（如 pathinfo($file, PATHINFO_EXTENSION)）：极易被绕过，存在严重安全隐患
mime_content_type()：已废弃（自 PHP 7.2 起），PHP 7.4 中仍可用但不推荐，功能等同于 finfo 但更难控制选项

? 补充：常见 MIME 类型白名单建议

业务中常需限制上传类型，建议按用途定义白名单，例如：

头像： ['image/jpeg', 'image/png', 'image/gif']
文档： ['application/pdf', 'application/msword', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document']
压缩包： ['application/zip', 'application/x-rar-compressed', 'application/x-7z-compressed']

注意：MIME 类型只是第一道防线，还需配合文件内容校验（如图片是否可渲染）、大小限制、存储路径隔离、执行权限禁用等措施。