結合前端 jQuery File Upload / Dropzone.js 風格的輕量插件與 PHP 後端,實現多檔案拖拽上傳、客戶端類型/大小預檢、服務端二次驗證、分塊上傳大檔、錯誤收集回報。本文提供最小可用代碼與生產級擴充方向。
<!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>
<?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 => '未知錯誤',
};
}
// 前端使用 Uppy + @uppy/xhr-upload (chunked)
// 後端新增 /upload/chunk 端點:
// - 接收 chunks, chunk, chunkSize, totalSize, fileName, identifier
// - 將分片存至 /tmp/uploads/{identifier}/part_{chunk}
// - 當 chunks === chunk+1 時,合併檔案並移動至正式目錄
// - 回傳 {success: true, path: '...'} 供前端完成
location /uploads { location ~ \.php$ { deny all; } }../)。finfo 二次驗證 MIME,防偽造 $_FILES['type']。limit_req_zone)。clamscan 非同步掃描,異常隔離。find /uploads -mtime +30 -delete)。