單檔上傳並不複雜,但實務上常需支援多檔同時上傳、檔案類型驗證(防止偽裝腳本)、重複檔名處理與上傳結果回報。本文提供完整、安全、可直接部署的實作範例。
<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
$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);
?>
<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>
finfo),不信任瀏覽器回傳的 $_FILES['type']php_flag engine off 或 SetHandler default-handler 禁止腳本執行clamscan)| 現象 | 可能原因 | 解決方向 |
|---|---|---|
| 大檔上傳失敗 | 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、擁有者、磁碟配額 |