upfile.php<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>檔案上傳</title></head>
<body>
<form action="upload.php" method="post" enctype="multipart/form-data">
<input type="hidden" name="MAX_FILE_SIZE" value="2097152"> <!-- 2MB 客戶端提示 -->
<input type="file" name="upfile" required><br><br>
<button type="submit">上傳檔案</button>
</form>
</body></html>
upload.php (含安全檢查)<?php
// upload.php
$uploadDir = __DIR__ . '/uploads/';
if (!is_dir($uploadDir)) {
mkdir($uploadDir, 0755, true);
}
// 1. 檢查上傳錯誤碼
if (!isset($_FILES['upfile']) || $_FILES['upfile']['error'] !== UPLOAD_ERR_OK) {
$errors = [
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 => '被擴充模組中斷',
];
die('上傳失敗: ' . ($errors[$_FILES['upfile']['error'] ?? '未知錯誤']));
}
$file = $_FILES['upfile'];
// 2. 基礎驗證
$maxSize = 2 * 1024 * 1024; // 2MB
if ($file['size'] > $maxSize) {
die('檔案過大,限制 2MB');
}
// 3. MIME 型別白名單 (不要信任瀏覽器提供的 type,需自行檢測)
$allowedMimes = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($file['tmp_name']);
if (!in_array($mime, $allowedMimes, true)) {
die('檔案類型不允許:' . $mime);
}
// 4. 副檔名白名單
$ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
$allowedExt = ['jpg', 'jpeg', 'png', 'gif', 'webp'];
if (!in_array($ext, $allowedExt, true)) {
die('副檔名不允許');
}
// 5. 生成安全檔名 (避免覆蓋、路徑遍歷、中文亂碼)
$safeName = bin2hex(random_bytes(16)) . '.' . $ext; // 32 字元十六進位 + 副檔名
$destPath = $uploadDir . $safeName;
// 6. 移動檔案 (使用 move_uploaded_file 確保是合法上傳檔)
if (!move_uploaded_file($file['tmp_name'], $destPath)) {
die('檔案移動失敗');
}
// 7. 成功回應
echo "上傳成功!
";
echo "原始檔名: " . htmlspecialchars($file['name']) . "
";
echo "儲存檔名: $safeName
";
echo "檔案大小: " . $file['size'] . " bytes
";
echo "MIME: $mime
";
if (str_starts_with($mime, 'image/')) {
echo "
";
}
?>
<?php
// 表單:
$files = $_FILES['files'];
$count = count($files['name']);
for ($i = 0; $i < $count; $i++) {
if ($files['error'][$i] !== UPLOAD_ERR_OK) continue;
$tmpName = $files['tmp_name'][$i];
$origName = $files['name'][$i];
$size = $files['size'][$i];
// 同樣驗證流程...
$ext = strtolower(pathinfo($origName, PATHINFO_EXTENSION));
$safeName = bin2hex(random_bytes(16)) . '.' . $ext;
move_uploaded_file($tmpName, $uploadDir . $safeName);
// 記錄資料庫...
}
?>
超過 PHP upload_max_filesize/post_max_size 或需斷點續傳時,採用前端切片 (如 uppy, dropzone, plupload) + 後端合併策略:
/upload/chunk。/tmp/uploads/{fileId}/part_{index}。/upload/merge。| 風險 | 防護措施 |
|---|---|
| 惡意腳本上傳 (.php, .phtml, .php5...) | 副檔名白名單 + MIME 檢測 + 儲存目錄禁用 PHP 解析 (Nginx location ~ \.php$ { deny all; }) |
| 檔名路徑遍歷 (../../../etc/passwd) | 捨棄原檔名,使用隨機生成檔名 |
| 檔案內容偽裝 (圖片夾帶 PHP 代碼) | 圖片重處理 imagecreatefromstring() 重新編碼、剝離 EXIF |
| DoS: 超大檔案佔滿磁碟/記憶體 | upload_max_filesize, post_max_size, MAX_FILE_SIZE, 磁碟配額 |
| 並發上傳衝突 | 隨機檔名 (bin2hex(random_bytes(16))) 幾乎零衝突 |
| 敏感資訊洩露 (錯誤訊息含路徑) | 生產環境關閉 display_errors,記錄日誌不顯示用戶 |
<?php
// Laravel Controller 範例
public function upload(Request $request)
{
$request->validate([
'file' => 'required|file|max:2048|mimes:jpg,jpeg,png,gif,webp|mimetypes:image/jpeg,image/png,image/gif,image/webp',
]);
$path = $request->file('file')->store('uploads', 'public'); // 自動生成隨機名、存 public/storage/uploads
return response()->json([
'url' => Storage::url($path),
'path' => $path,
]);
}
?>
檔案上傳看似簡單,實則是安全攻擊面最集中的功能之一。**核心原則:不信任任何客戶端資料 (檔名、MIME、大小)、白名單驗證、隨機化儲存名稱、儲存目錄與 Web 根目錄隔離、禁用腳本執行權限**。現代框架已封裝完善,直接使用框架提供的上傳元件最安全高效。