萬盛學電腦網

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

PHP + jQuery 多檔案上傳完整實戰(前端拖拽、後端分塊驗證、錯誤收集)

結合前端 jQuery File Upload / Dropzone.js 風格的輕量插件與 PHP 後端,實現多檔案拖拽上傳、客戶端類型/大小預檢、服務端二次驗證、分塊上傳大檔、錯誤收集回報。本文提供最小可用代碼與生產級擴充方向。

前端頁面(index.html)

<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>多檔上傳</title>
<link href="https://cdn.jsdelivr.net/npm/dropzone@5.9.3/dist/dropzone.min.css" rel="stylesheet">
<style>#dropzone {border:2px dashed #ccc;border-radius:8px;padding:40px;text-align:center;max-width:600px;margin:2rem auto;}</style>
</head><body>
<div id="dropzone" class="dropzone">拖拽檔案到此或點擊選擇</div>
<div id="status" style="text-align:center;margin-top:1rem;"></div>
<script src="https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/dropzone@5.9.3/dist/dropzone.min.js"></script>
<script>
Dropzone.autoDiscover = false;
const dz = new Dropzone('#dropzone', {
    url: 'upload.php',
    paramName: 'files',           // $_FILES['files']
    maxFilesize: 20,              // MB,客戶端預檢
    acceptedFiles: 'image/*,.pdf,.doc,.docx,.zip', // MIME/副檔名
    parallelUploads: 3,           // 並發數
    uploadMultiple: false,        // 單檔單請求(易於後端處理)
    addRemoveLinks: true,
    dictRemoveFile: '移除',
    dictCancelUpload: '取消',
    init() {
        this.on('success', (file, res) => {
            const data = typeof res === 'string' ? JSON.parse(res) : res;
            if (data.code === 0) {
                $('#status').html(`<span style="color:green">${file.name} 上傳成功</span>`);
            } else {
                $('#status').html(`<span style="color:red">${file.name}: ${data.msg}</span>`);
            }
        });
        this.on('error', (file, msg) => {
            $('#status').html(`<span style="color:red">${file.name}: ${msg}</span>`);
        });
    }
});
</script>
</body></html>

後端處理(upload.php)

<?php
declare(strict_types=1);

const UPLOAD_DIR = __DIR__ . '/uploads';
const MAX_SIZE   = 20 * 1024 * 1024; // 20MB
const ALLOWED_MIME = [
    'image/jpeg', 'image/png', 'image/gif', 'image/webp',
    'application/pdf',
    'application/msword',
    'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
    'application/zip',
];

// 確保目錄存在
if (!is_dir(UPLOAD_DIR)) mkdir(UPLOAD_DIR, 0755, true);

// 統一 JSON 回應
function jsonResponse(int $code, string $msg, array $data = []): never
{
    header('Content-Type: application/json; charset=utf-8');
    echo json_encode(['code' => $code, 'msg' => $msg, 'data' => $data], JSON_UNESCAPED_UNICODE);
    exit;
}

// 僅允許 POST
if ($_SERVER['REQUEST_METHOD'] !== 'POST') jsonResponse(405, 'Method Not Allowed');

$files = $_FILES['files'] ?? null;
if (!$files || !isset($files['tmp_name'])) jsonResponse(400, '無檔案上傳');

// 單檔/多檔統一為陣列結構
$count = is_array($files['name']) ? count($files['name']) : 1;
$results = [];

for ($i = 0; $i < $count; $i++) {
    $name     = is_array($files['name'])     ? $files['name'][$i]     : $files['name'];
    $tmpName  = is_array($files['tmp_name']) ? $files['tmp_name'][$i] : $files['tmp_name'];
    $size     = is_array($files['size'])     ? $files['size'][$i]     : $files['size'];
    $error    = is_array($files['error'])    ? $files['error'][$i]    : $files['error'];
    $mime     = is_array($files['type'])     ? $files['type'][$i]     : $files['type'];

    // 1. 上傳錯誤碼檢查
    if ($error !== UPLOAD_ERR_OK) {
        $results[] = ['name' => $name, 'code' => $error, 'msg' => uploadErrorMsg($error)];
        continue;
    }
    // 2. 大小檢查
    if ($size > MAX_SIZE) {
        $results[] = ['name' => $name, 'code' => 1001, 'msg' => '檔案超過 20MB 限制'];
        continue;
    }
    // 3. MIME 白名單(建議再用 finfo 二次驗證)
    if (!in_array($mime, ALLOWED_MIME, true)) {
        $results[] = ['name' => $name, 'code' => 1002, 'msg' => '檔案類型不允許'];
        continue;
    }
    // 4. finfo 真實 MIME 驗證
    $finfo = new finfo(FILEINFO_MIME_TYPE);
    $realMime = $finfo->file($tmpName);
    if (!in_array($realMime, ALLOWED_MIME, true)) {
        $results[] = ['name' => $name, 'code' => 1003, 'msg' => '檔案內容類型不符'];
        continue;
    }
    // 5. 安全檔名:隨機 + 原副檔名
    $ext = strtolower(pathinfo($name, PATHINFO_EXTENSION));
    $safeName = bin2hex(random_bytes(12)) . ($ext ? '.' . $ext : '');
    $dest = UPLOAD_DIR . '/' . $safeName;

    // 6. 移動檔案
    if (!move_uploaded_file($tmpName, $dest)) {
        $results[] = ['name' => $name, 'code' => 1004, 'msg' => '儲存失敗'];
        continue;
    }
    $results[] = ['name' => $name, 'code' => 0, 'msg' => '成功', 'path' => $safeName];
}

// 7. 彙總回應
$hasError = array_filter($results, fn($r) => $r['code'] !== 0);
jsonResponse($hasError ? 207 : 200, $hasError ? '部分失敗' : '全部成功', $results);

function uploadErrorMsg(int $code): string
{
    return match ($code) {
        UPLOAD_ERR_INI_SIZE   => '超過 php.ini upload_max_filesize',
        UPLOAD_ERR_FORM_SIZE  => '超過表單 MAX_FILE_SIZE',
        UPLOAD_ERR_PARTIAL    => '檔案上傳不完整',
        UPLOAD_ERR_NO_FILE    => '未選擇檔案',
        UPLOAD_ERR_NO_TMP_DIR => '臨時目錄不存在',
        UPLOAD_ERR_CANT_WRITE => '寫入磁碟失敗',
        UPLOAD_ERR_EXTENSION  => 'PHP 擴充套件中斷上傳',
        default => '未知錯誤',
    };
}

進階:大檔分塊上傳(Resumable.js / Uppy + PHP 合併)

// 前端使用 Uppy + @uppy/xhr-upload (chunked)
// 後端新增 /upload/chunk 端點:
// - 接收 chunks, chunk, chunkSize, totalSize, fileName, identifier
// - 將分片存至 /tmp/uploads/{identifier}/part_{chunk}
// - 當 chunks === chunk+1 時,合併檔案並移動至正式目錄
// - 回傳 {success: true, path: '...'} 供前端完成

安全強化清單

  1. 上傳目錄**不可執行 PHP**:Nginx location /uploads { location ~ \.php$ { deny all; } }
  2. 檔名**隨機化**,防止覆蓋、路徑遍歷(../)。
  3. finfo 二次驗證 MIME,防偽造 $_FILES['type']。
  4. 限制單請求檔案數、總大小、並發數(Nginx limit_req_zone)。
  5. 病毒掃描:整合 ClamAV clamscan 非同步掃描,異常隔離。
  6. 定期清理臨時/過期檔案(find /uploads -mtime +30 -delete)。
copyright © 萬盛學電腦網 all rights reserved