PHP $_FILES 檔案上傳超全域陣列詳細解析
$_FILES 存放經 HTTP POST 上傳的檔案資訊 (舊版 $HTTP_POST_FILES 已棄用)。正確理解其結構、錯誤碼與安全處理流程,是檔案上傳功能的基石。
$_FILES 結構 (單一檔案 name="myFile")
| 鍵名 | 說明 | 範例 |
name | 客戶端原始檔名 | photo.jpg |
type | 瀏覽器回報 MIME 型別 (不可信) | image/jpeg |
size | 檔案大小 (位元組) | 204800 |
tmp_name | 伺服器暫存路徑 (PHP 執行結束自動刪除) | /tmp/phpA1b2C3 |
error | 上傳錯誤碼 (PHP 4.2.0+) | 0 (UPLOAD_ERR_OK) |
錯誤碼對照表 (常數)
| 常數 | 值 | 原因 |
UPLOAD_ERR_OK | 0 | 成功 |
UPLOAD_ERR_INI_SIZE | 1 | 超過 php.ini upload_max_filesize |
UPLOAD_ERR_FORM_SIZE | 2 | 超過表單 MAX_FILE_SIZE 隱藏欄位 |
UPLOAD_ERR_PARTIAL | 3 | 僅部分上傳 (網路中斷) |
UPLOAD_ERR_NO_FILE | 4 | 沒有檔案上傳 |
UPLOAD_ERR_NO_TMP_DIR | 6 | 缺少暫存目錄 (PHP 5.0.3+) |
UPLOAD_ERR_CANT_WRITE | 7 | 寫入磁碟失敗 (PHP 5.1.0+) |
UPLOAD_ERR_EXTENSION | 8 | PHP 擴展中斷上傳 (PHP 5.2.0+) |
HTML 表單必要條件
<form action="upload.php" method="post" enctype="multipart/form-data">
<input type="file" name="myFile" id="myFile">
<input type="submit" value="上傳">
</form>
- 必須
enctype="multipart/form-data",否則 $_FILES 為空。
method="post" (GET 不支援檔案上傳)。
安全驗證與處理流程 (精簡版)
<?php
// 1. 檢查請求方法與檔案是否存在
if ($_SERVER['REQUEST_METHOD'] !== 'POST' || empty($_FILES['myFile'])) {
die('無效請求');
}
$file = $_FILES['myFile'];
// 2. 檢查錯誤碼
if ($file['error'] !== UPLOAD_ERR_OK) {
die('上傳錯誤代碼: ' . $file['error']);
}
// 3. 驗證 MIME 型別 (不可信任瀏覽器提供的 type,需伺服端檢測)
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($file['tmp_name']);
$allowedMimes = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
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. 驗證檔案大小 (雙重保險)
$maxSize = 2 * 1024 * 1024; // 2MB
if ($file['size'] > $maxSize) {
die('檔案過大');
}
// 6. 產生安全儲存檔名 (避免覆蓋、路徑遍歷、執行腳本)
$newName = bin2hex(random_bytes(16)) . '.' . $ext; // 隨機檔名
$destDir = __DIR__ . '/uploads/';
if (!is_dir($destDir)) mkdir($destDir, 0755, true);
$destPath = $destDir . $newName;
// 7. 移動暫存檔到永久位置 (is_uploaded_file 防偽造)
if (!is_uploaded_file($file['tmp_name'])) {
die('非合法上傳檔案');
}
if (!move_uploaded_file($file['tmp_name'], $destPath)) {
die('移動檔案失敗');
}
// 8. 設定檔案權限 (僅擁有者可讀寫)
chmod($destPath, 0644);
echo "上傳成功: $newName";
?>
關鍵安全點總結
- 永遠驗證 MIME 型別:用
finfo (Fileinfo 擴展) 而非 $_FILES['type']。
- 檔名隨機化:防止覆蓋、路徑遍歷、惡意副檔名執行。
- 儲存目錄不可執行 PHP**:Nginx/Apache 設定
uploads 目錄禁用腳本執行。
- 限制大小:php.ini
upload_max_filesize, post_max_size + 程式碼雙重檢查。
- 掃描惡意內容:整合 ClamAV、VirusTotal API 等。
- 資料庫記錄元資料:原始檔名、儲存路徑、MIME、大小、上傳者、時間。
多檔案上傳 (name="files[]")
<?php
foreach ($_FILES['files']['tmp_name'] as $index => $tmpName) {
$error = $_FILES['files']['error'][$index];
if ($error !== UPLOAD_ERR_OK) continue;
$name = $_FILES['files']['name'][$index];
// ... 單檔驗證邏輯 ...
}
?>