文件上傳是 Web 開發高頻需求,亦是安全重災區。本文從 HTML 表單規範、$_FILES 詳解、核心處理流程、安全加固四個維度構建生產級上傳方案。
<form action="upload.php" method="POST" enctype="multipart/form-data">
<input type="hidden" name="MAX_FILE_SIZE" value="33554432"> <!-- 32MB,瀏覽器端攔截 -->
<input type="file" name="file" id="file" accept=".pdf,.jpg,.png">
<input type="submit" value="上傳">
</form>
enctype="multipart/form-data":必須,否則 $_FILES 為空。MAX_FILE_SIZE:瀏覽器端提示,非服務端強制,需後端二次校驗。accept:限制文件類型,僅為 UX 輔助。$_FILES['file'] = [
'name' => 'photo.jpg', // 原始文件名(用戶可控,不可信)
'type' => 'image/jpeg', // MIME 類型(瀏覽器推測,不可信)
'tmp_name' => '/tmp/phpXyZ123', // 臨時存儲路徑(處理完自動刪除)
'size' => 204800, // 字節大小
'error' => UPLOAD_ERR_OK // 錯誤碼:0=成功,1=超過 php.ini upload_max_filesize,2=超過 MAX_FILE_SIZE,3=部分上傳,4=無文件,6=無臨時目錄
];
<?php
const UPLOAD_DIR = __DIR__ . '/uploads';
const ALLOWED_MIME = ['image/jpeg', 'image/png', 'application/pdf'];
const MAX_SIZE = 10 * 1024 * 1024; // 10MB
// 1. 基礎校驗
if (!isset($_FILES['file']) || $_FILES['file']['error'] !== UPLOAD_ERR_OK) {
exit(json_encode(['code'=>400, 'msg'=> '上傳失敗或無文件']));
}
if ($_FILES['file']['size'] > MAX_SIZE) {
exit(json_encode(['code'=>413, 'msg'=> '文件過大']));
}
// 2. MIME 類型二次校驗(使用 finfo,不可信 $_FILES['type'])
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($_FILES['file']['tmp_name']);
if (!in_array($mime, ALLOWED_MIME, true)) {
exit(json_encode(['code'=>415, 'msg'=> '禁止的文件類型']));
}
// 3. 構建安全存儲名稱(防覆蓋、防路徑遍歷、防執行)
$ext = pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION);
$safeName = bin2hex(random_bytes(16)) . '.' . strtolower($ext);
$destPath = UPLOAD_DIR . '/' . date('Y/m/d') . '/' . $safeName;
// 4. 確保目錄存在
if (!is_dir(dirname($destPath))) {
mkdir(dirname($destPath), 0755, true);
}
// 5. 移動文件(原子操作,跨分區自動複製+刪除)
if (!move_uploaded_file($_FILES['file']['tmp_name'], $destPath)) {
exit(json_encode(['code'=>500, 'msg'=> '存儲失敗']));
}
// 6. 可選:圖片二次渲染(去除 EXIF、殘留腳本)
if (str_starts_with($mime, 'image/')) {
$img = imagecreatefromstring(file_get_contents($destPath));
imagejpeg($img, $destPath, 85);
imagedestroy($img);
}
echo json_encode(['code'=>200, 'path'=> $destPath, 'url'=> '/uploads/' . date('Y/m/d') . '/' . $safeName]);
finfo 驗證真實 MIME,而非 $_FILES['type']。location ~* \.php$ { deny all; })。open_basedir 限制 PHP 訪問範圍。clamscan 異步掃描。文件上傳「易學難精」。掌握 $_FILES 結構、move_uploaded_file 原子性、MIME 真實驗證、存儲路徑隨機化、目錄執行權限隔離,即可構建安全可靠的上傳服務。