多檔案上傳的關鍵在於 HTML 表單的 name="files[]" 陣列命名,以及後端遍歷 $_FILES 陣列逐一處理。本文提供完整、安全、可直接部署的實作範例。
<!DOCTYPE html>
<html lang="zh-Hant">
<head>
<meta charset="UTF-8">
<title>多檔案上傳</title>
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body class="bg-light">
<div class="container py-5">
<div class="card shadow">
<div class="card-header bg-primary text-white"><h4>批量檔案上傳</h4></div>
<div class="card-body">
<form action="upload_multiple.php" method="post" enctype="multipart/form-data" id="uploadForm">
<div class="mb-3">
<label class="form-label">選擇多個檔案(按住 Ctrl/Shift 多選)</label>
<input type="file" name="files[]" id="fileInput" class="form-control" multiple required>
<div class="form-text">支援:jpg, png, gif, pdf, docx,單檔限制 5MB</div>
</div>
<button type="submit" name="submit" class="btn btn-success">開始上傳</button>
<div id="result" class="mt-3"></div>
</form>
</div>
</div>
</div>
</body>
</html>
<?php
// upload_multiple.php
declare(strict_types=1);
const UPLOAD_DIR = __DIR__ . '/uploads/';
const MAX_FILE_SIZE = 5 * 1024 * 1024; // 5MB
const ALLOWED_MIME = [
'image/jpeg', 'image/png', 'image/gif', 'image/webp',
'application/pdf',
'application/msword',
'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
];
const ALLOWED_EXT = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'pdf', 'doc', 'docx'];
// 確保上傳目錄存在且可寫
if (!is_dir(UPLOAD_DIR)) {
mkdir(UPLOAD_DIR, 0755, true);
}
if (!is_writable(UPLOAD_DIR)) {
http_response_code(500);
exit(json_encode(['success' => false, 'message' => '上傳目錄不可寫入']));
}
header('Content-Type: application/json; charset=utf-8');
if ($_SERVER['REQUEST_METHOD'] !== 'POST' || empty($_FILES['files'])) {
http_response_code(400);
exit(json_encode(['success' => false, 'message' => '無效請求']));
}
$results = [];
$files = $_FILES['files'];
// 整理 $_FILES 陣列結構:從平行陣列轉為逐檔案陣列
$fileCount = count($files['name']);
$normalized = [];
for ($i = 0; $i < $fileCount; $i++) {
$normalized[] = [
'name' => $files['name'][$i],
'type' => $files['type'][$i],
'tmp_name' => $files['tmp_name'][$i],
'error' => $files['error'][$i],
'size' => $files['size'][$i],
];
}
foreach ($normalized as $index => $file) {
$result = ['original_name' => $file['name']];
// 1. 檢查上傳錯誤碼
if ($file['error'] !== UPLOAD_ERR_OK) {
$result['success'] = false;
$result['message'] = match ($file['error']) {
UPLOAD_ERR_INI_SIZE, UPLOAD_ERR_FORM_SIZE => '檔案超過大小限制',
UPLOAD_ERR_PARTIAL => '檔案上傳不完整',
UPLOAD_ERR_NO_FILE => '未選擇檔案',
UPLOAD_ERR_NO_TMP_DIR => '伺服器臨時目錄缺失',
UPLOAD_ERR_CANT_WRITE => '伺服器寫入失敗',
UPLOAD_ERR_EXTENSION => 'PHP 擴充功能中斷上傳',
default => '未知上傳錯誤',
};
$results[] = $result;
continue;
}
// 2. 檢查檔案大小
if ($file['size'] > MAX_FILE_SIZE) {
$result['success'] = false;
$result['message'] = '檔案大小超過 ' . (MAX_FILE_SIZE / 1024 / 1024) . 'MB 限制';
$results[] = $result;
continue;
}
// 3. 檢查 MIME 型別(需搭配 finfo 確認真實型別)
$finfo = new finfo(FILEINFO_MIME_TYPE);
$realMime = $finfo->file($file['tmp_name']);
if (!in_array($realMime, ALLOWED_MIME, true)) {
$result['success'] = false;
$result['message'] = '檔案類型不允許(偵測為 ' . $realMime . ')';
$results[] = $result;
continue;
}
// 4. 檢查副檔名
$ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
if (!in_array($ext, ALLOWED_EXT, true)) {
$result['success'] = false;
$result['message'] = '副檔名不允許';
$results[] = $result;
continue;
}
// 5. 產生安全檔名:時間戳 + 隨機字串 + 原始副檔名
$safeName = sprintf('%s_%s.%s', date('YmdHis'), bin2hex(random_bytes(8)), $ext);
$destPath = UPLOAD_DIR . $safeName;
// 6. 移動檔案
if (!move_uploaded_file($file['tmp_name'], $destPath)) {
$result['success'] = false;
$result['message'] = '檔案儲存失敗(權限或磁碟空間不足)';
$results[] = $result;
continue;
}
// 成功
$result['success'] = true;
$result['saved_name'] = $safeName;
$result['path'] = $destPath;
$result['size'] = $file['size'];
$result['mime'] = $realMime;
$results[] = $result;
}
// 回傳結果
$successCount = count(array_filter($results, fn($r) => $r['success']));
echo json_encode([
'success' => $successCount > 0,
'total' => count($results),
'success_count' => $successCount,
'files' => $results,
], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
?>
<script>
document.getElementById('uploadForm').addEventListener('submit', async (e) => {
e.preventDefault();
const formData = new FormData(e.target);
const resultDiv = document.getElementById('result');
resultDiv.innerHTML = '<div class="text-center"><div class="spinner-border"></div> 上傳中...</div>';
try {
const res = await fetch('upload_multiple.php', { method: 'POST', body: formData });
const data = await res.json();
renderResult(data);
} catch (err) {
resultDiv.innerHTML = '<div class="alert alert-danger">網路錯誤:' + err.message + '</div>';
}
});
function renderResult(data) {
const div = document.getElementById('result');
if (data.success) {
let html = '<div class="alert alert-success">成功上傳 ' + data.success_count + ' / ' + data.total + ' 個檔案</div>';
html += '<ul class="list-group">';
data.files.forEach(f => {
const badge = f.success ? 'success' : 'danger';
html += `<li class="list-group-item d-flex justify-content-between">
<span>${f.original_name}</span>
<span class="badge bg-${badge}">${f.success ? '成功' : '失敗: ' + f.message}</span>
</li>`;
});
html += '</ul>';
div.innerHTML = html;
} else {
div.innerHTML = '<div class="alert alert-danger">' + (data.message || '上傳失敗') + '</div>';
}
}
</script>
finfo 偵測真實檔案型別,防止偽裝副檔名php.ini upload_max_filesize, post_max_size)php_flag engine off 或放在 Web Root 外,防止直接執行上傳的腳本Content-Security-Policy、X-Content-Type-Options: nosniff多檔案上傳的核心是 name="files[]" + multiple 屬性,後端以 $_FILES['files'] 陣列結構遍歷處理。配合 MIME 檢查、隨機檔名、權限隔離,即可構建安全可靠的上傳功能。