萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 多檔案圖片上傳與格式驗證完整實作

單檔上傳並不複雜,但實務上常需支援多檔同時上傳、檔案類型驗證(防止偽裝腳本)、重複檔名處理與上傳結果回報。本文提供完整、安全、可直接部署的實作範例。

HTML 表單(支援多檔選擇)

<form action="upload.php" method="post" enctype="multipart/form-data">
  <input type="file" name="imgfile[]" multiple accept="image/*">
  <input type="submit" value="上傳圖片">
</form>

關鍵點:name="imgfile[]" 陣列命名 + multiple 屬性 + accept="image/*" 客戶端預先過濾。

PHP 處理邏輯 (upload.php)

<?php
$uploadDir = __DIR__ . '/uploads/';
if (!is_dir($uploadDir)) mkdir($uploadDir, 0755, true);

// 允許的 MIME 類型
$allowedTypes = [
    'image/jpeg' => 'jpg',
    'image/png'  => 'png',
    'image/gif'  => 'gif',
    'image/webp' => 'webp',
    'image/bmp'  => 'bmp',
];

$maxFiles = 5;
$maxSize  = 5 * 1024 * 1024; // 5MB

$results = ['success' => [], 'failed' => []];

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['imgfile'])) {
    $files = $_FILES['imgfile'];
    $count = count($files['name']);

    for ($i = 0; $i < min($count, $maxFiles); $i++) {
        $name     = $files['name'][$i];
        $tmpName  = $files['tmp_name'][$i];
        $size     = $files['size'][$i];
        $error    = $files['error'][$i];
        $type     = $files['type'][$i];

        if ($error !== UPLOAD_ERR_OK) {
            $results['failed'][] = ['name' => $name, 'reason' => '上傳錯誤代碼: ' . $error];
            continue;
        }

        if ($size > $maxSize) {
            $results['failed'][] = ['name' => $name, 'reason' => '檔案過大 (最大 ' . ($maxSize/1024/1024) . 'MB)'];
            continue;
        }

        // 伺服器端二次驗證 MIME(防偽裝)
        $finfo = finfo_open(FILEINFO_MIME_TYPE);
        $realType = finfo_file($finfo, $tmpName);
        finfo_close($finfo);

        if (!isset($allowedTypes[$realType])) {
            $results['failed'][] = ['name' => $name, 'reason' => '不支援的檔案類型: ' . $realType];
            continue;
        }

        // 產生唯一檔名避免衝突
        $ext = $allowedTypes[$realType];
        $newName = date('YmdHis') . '_' . bin2hex(random_bytes(4)) . '.' . $ext;
        $destPath = $uploadDir . $newName;

        if (move_uploaded_file($tmpName, $destPath)) {
            $results['success'][] = [
                'original' => $name,
                'saved'    => $newName,
                'size'     => $size,
                'type'     => $realType,
                'url'      => '/uploads/' . $newName
            ];
        } else {
            $results['failed'][] = ['name' => $name, 'reason' => '移動檔案失敗'];
        }
    }
}

// 輸出 JSON 供前端 AJAX 使用,或直接 include 顯示頁面
header('Content-Type: application/json; charset=utf-8');
echo json_encode($results, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
?>

前端 AJAX 整合範例 (jQuery)

<script>
$('form').on('submit', function(e) {
    e.preventDefault();
    var formData = new FormData(this);
    $.ajax({
        url: 'upload.php',
        type: 'POST',
        data: formData,
        processData: false,
        contentType: false,
        success: function(res) {
            var html = '';
            res.success.forEach(function(f) {
                html += '<div class="success"><img src="' + f.url + '" width="100"> ' + f.original + ' (' + (f.size/1024).toFixed(1) + 'KB)</div>';
            });
            res.failed.forEach(function(f) {
                html += '<div class="error">' + f.name + ': ' + f.reason + '</div>';
            });
            $('#results').html(html);
        }
    });
});
</script>
<div id="results"></div>

安全性檢查清單

  • ✅ 伺服器端驗證 MIME Type (finfo),不信任瀏覽器回傳的 $_FILES['type']
  • ✅ 限制副檔名與 MIME 白名單雙重驗證
  • ✅ 重新命名檔案(時間戳+隨機字串),防止覆蓋與路徑遍歷
  • ✅ 上傳目錄設定 php_flag engine off 或 SetHandler default-handler 禁止腳本執行
  • ✅ 限制單檔/總大小、檔案數量
  • ✅ 病毒掃描整合(如 ClamAV clamscan)
  • ✅ 記錄上傳日誌(用戶、IP、檔名、時間、結果)

常見問題排查

現象可能原因解決方向
大檔上傳失敗php.ini upload_max_filesize/post_max_size 過小調大至 100M 以上,並檢查 Nginx client_max_body_size
$_FILES 為空表單缺 enctype="multipart/form-data"補上屬性
move_uploaded_file 失敗目錄權限、磁碟空間、open_basedir 限制檢查權限 0755、擁有者、磁碟配額
copyright © 萬盛學電腦網 all rights reserved