PHP 怎么PHP 文件类型验证

wen PHP项目 2026-07-30 4

本文目录导读：

PHP 怎么PHP 文件类型验证

使用 $_FILES 的 type 属性（不推荐单独使用）
使用 finfo 函数（推荐）
使用 exif_imagetype() 验证图片
完整的文件上传验证示例
常见 MIME 类型映射表
最佳实践建议

在 PHP 中进行文件类型验证有多种方法，我为您详细介绍几种常用方式：

使用 `$_FILES` 的 `type` 属性（不推荐单独使用）

<?php
$allowedTypes = ['image/jpeg', 'image/png', 'image/gif'];
$fileType = $_FILES['file']['type'];
if (in_array($fileType, $allowedTypes)) {
    echo "文件类型有效";
} else {
    echo "文件类型无效";
}

⚠️ 注意：这个值来自客户端，可以伪造，不能作为唯一验证依据。

使用 `finfo` 函数（推荐）

这是最可靠的方法,通过读取文件内容检测MIME类型：

<?php
function validateFileType($filePath, $allowedTypes) {
    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    $mimeType = finfo_file($finfo, $filePath);
    finfo_close($finfo);
    return in_array($mimeType, $allowedTypes);
}
// 使用示例
$allowedTypes = ['image/jpeg', 'image/png', 'image/gif', 'application/pdf'];
if (isset($_FILES['file'])) {
    $file = $_FILES['file']['tmp_name'];
    if (validateFileType($file, $allowedTypes)) {
        echo "文件类型验证通过";
    } else {
        echo "不支持的文件类型";
    }
}

使用 `exif_imagetype()` 验证图片

专门用于图片文件的验证：

<?php
function validateImageType($filePath, $allowedTypes = []) {
    $imageType = exif_imagetype($filePath);
    // 常见的图片类型常量
    $imageTypes = [
        IMAGETYPE_JPEG => 'image/jpeg',
        IMAGETYPE_PNG => 'image/png',
        IMAGETYPE_GIF => 'image/gif',
        IMAGETYPE_WEBP => 'image/webp'
    ];
    if ($imageType !== false && isset($imageTypes[$imageType])) {
        $mimeType = $imageTypes[$imageType];
        return empty($allowedTypes) ? true : in_array($mimeType, $allowedTypes);
    }
    return false;
}
// 使用示例
$allowedTypes = ['image/jpeg', 'image/png'];
if (validateImageType($_FILES['image']['tmp_name'], $allowedTypes)) {
    echo "有效的图片文件";
}

完整的文件上传验证示例

<?php
function validateFileUpload($file) {
    $errors = [];
    // 检查上传错误
    if ($file['error'] !== UPLOAD_ERR_OK) {
        $errors[] = "上传失败，错误代码：" . $file['error'];
        return $errors;
    }
    // 允许的文件类型
    $allowedTypes = [
        'image/jpeg',
        'image/png', 
        'image/gif',
        'application/pdf',
        'application/msword',
        'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
    ];
    // 允许的文件大小（5MB）
    $maxFileSize = 5 * 1024 * 1024;
    // 1. 使用 finfo 验证 MIME 类型
    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    $mimeType = finfo_file($finfo, $file['tmp_name']);
    finfo_close($finfo);
    if (!in_array($mimeType, $allowedTypes)) {
        $errors[] = "文件类型不支持：" . $mimeType;
    }
    // 2. 验证文件大小
    if ($file['size'] > $maxFileSize) {
        $errors[] = "文件大小超过限制（最大5MB）";
    }
    // 3. 对于图片文件，额外使用 getimagesize 验证
    if (strpos($mimeType, 'image/') === 0) {
        if (getimagesize($file['tmp_name']) === false) {
            $errors[] = "无效的图片文件";
        }
    }
    // 4. 验证文件扩展名（辅助验证）
    $extension = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
    $allowedExtensions = ['jpg', 'jpeg', 'png', 'gif', 'pdf', 'doc', 'docx'];
    if (!in_array($extension, $allowedExtensions)) {
        $errors[] = "文件扩展名不允许";
    }
    return $errors;
}
// 使用示例
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['file'])) {
    $errors = validateFileUpload($_FILES['file']);
    if (empty($errors)) {
        // 处理文件上传
        $uploadDir = 'uploads/';
        $filename = uniqid() . '-' . basename($_FILES['file']['name']);
        if (move_uploaded_file($_FILES['file']['tmp_name'], $uploadDir . $filename)) {
            echo "文件上传成功！";
        } else {
            echo "文件移动失败！";
        }
    } else {
        foreach ($errors as $error) {
            echo "<p style='color:red;'>$error</p>";
        }
    }
}
?>
<form method="post" enctype="multipart/form-data">
    <input type="file" name="file" required>
    <button type="submit">上传文件</button>
</form>

常见 MIME 类型映射表

<?php
$commonMimeTypes = [
    // 图片
    'jpeg' => 'image/jpeg',
    'jpg'  => 'image/jpeg',
    'png'  => 'image/png',
    'gif'  => 'image/gif',
    'webp' => 'image/webp',
    // 文档
    'pdf'  => 'application/pdf',
    'doc'  => 'application/msword',
    'docx' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
    'xls'  => 'application/vnd.ms-excel',
    'xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
    // 压缩文件
    'zip'  => 'application/zip',
    'rar'  => 'application/vnd.rar',
    'gz'   => 'application/gzip',
    // 其他
    'txt'  => 'text/plain',
    'csv'  => 'text/csv',
    'xml'  => 'application/xml',
    'json' => 'application/json'
];