很多開發者遇到過這個困惑:用戶上傳文件後,PHP 返回臨時文件路徑($_FILES['file']['tmp_name']),但下一個請求嘗試讀取該文件時**已不存在**。本文深入剖析 PHP 上傳文件臨時存儲的生命週期、自動回收機制,並給出正確處理流程。
multipart/form-data 請求upload_tmp_dir(默認系統臨時目錄)寫入**臨時文件**SAPI_POST_HANDLER(如 php_apache_sapi_module)$_FILES 超全局數組:
tmp_name:臨時文件完整路徑(如 /tmp/phpA1b2C3)name:原始文件名size、type、error核心鐵律: $_FILES['tmp_name'] 指向的臨時文件,**僅在當前請求生命週期內有效**。請求結束(正常返回、拋出異常、exit/die、致命錯誤)時,PHP 內核會遍歷 SG(rfc1867_uploaded_files) 鏈表,**無條件 unlink() 刪除**所有臨時文件。
<?php
// upload_test.php
// 故意睡眠 30 秒,方便觀察臨時文件
sleep(30);
var_dump($_FILES);
// 此期間去 /tmp 可見 phpXXXXXX 文件
// 腳本結束後文件自動消失
?>

即使腳本中途 exit、拋出未捕獲異常、觸發致命錯誤,PHP 內核的 RSHUTDOWN 階段依然會執行清理。**唯一例外**:進程被 SIGKILL (kill -9) 強制終止,臨時文件會殘留(需靠系統 tmpwatch 定期清理)。
<?php
// 處理上傳的標準模式
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['avatar'])) {
$file = $_FILES['avatar'];
// 1. 驗證錯誤碼
if ($file['error'] !== UPLOAD_ERR_OK) {
throw new RuntimeException('上傳失敗,錯誤碼: ' . $file['error']);
}
// 2. 驗證文件類型/大小(業務邏輯)
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($file['tmp_name']);
$allowed = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
if (!in_array($mime, $allowed)) {
throw new RuntimeException('不支持的文件類型');
}
// 3. 構建目標路徑(不可預測、按日期分目錄、副檔名白名單)
$ext = match($mime) {
'image/jpeg' => 'jpg',
'image/png' => 'png',
'image/gif' => 'gif',
'image/webp' => 'webp',
};
$dateDir = date('Y/m/d');
$targetDir = "/var/www/uploads/$dateDir";
if (!is_dir($targetDir)) mkdir($targetDir, 0755, true);
$filename = bin2hex(random_bytes(16)) . ".$ext"; // 隨機文件名
$targetPath = "$targetDir/$filename";
// 4. 核心步驟:移動臨時文件到永久位置
// move_uploaded_file() 會檢查文件是否真的是上傳文件(防偽造)
if (!move_uploaded_file($file['tmp_name'], $targetPath)) {
throw new RuntimeException('文件移動失敗');
}
// 5. 設置權限、記錄數據庫、返回 URL
chmod($targetPath, 0644);
$url = "/uploads/$dateDir/$filename";
echo json_encode(['success' => true, 'url' => $url]);
}
?>
| 錯誤模式 | 後果 | 修正 |
|---|---|---|
直接用 copy() 複製臨時文件 | 繞過 is_uploaded_file() 檢查,安全風險;請求結束臨時文件仍被刪除 | 用 move_uploaded_file()(原子移動、自動驗證、源文件消失) |
將 tmp_name 存入 Session/DB,下一請求處理 | 下一請求時文件已被刪除,讀取失敗 | **當前請求內完成移動**,只存儲最終永久路徑/URL |
用 file_get_contents($tmp_name) 讀取內容處理 | 大文件導致記憶體爆炸(受 memory_limit 限制) | 流式處理或直接 move_uploaded_file 後再用流處理永久文件 |
| 多步驟表單:第一步上傳,第二步確認 | 第一步請求結束文件即刪除 | 第一步直接移至永久暫存區,DB 記錄狀態=暫存,第二步確認轉正或定時清理暫存區 |
; php.ini
; 臨時目錄(建議獨立分區、SSD、大容量)
upload_tmp_dir = /var/php_upload_tmp
; 最大上傳文件大小
upload_max_filesize = 50M
post_max_size = 55M ; 必須 > upload_max_filesize
; 最大文件數
max_file_uploads = 20
; 關閉文件上傳(不需要時)
file_uploads = Off
超大文件(>100MB)不建議單次上傳,採用**前端分片 + 後端合併**:
/api/upload/chunk/var/uploads/chunks/{uploadId}/part_{index}/api/upload/mergefopen($final, 'ab') 追加寫入合併,驗證完整性(MD5/SHA256)此架構下,**每個分片請求獨立完成 move_uploaded_file**,完全避開臨時文件生命週期限制。
move_uploaded_file() 移至永久存儲。理解臨時文件「生於請求,死於請求」的本質,是處理文件上傳業務穩健的前提。