萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP $_FILES 超全域陣列完整指南:檔案上傳結構、錯誤碼、安全驗證與精簡範例

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_OK0成功
UPLOAD_ERR_INI_SIZE1超過 php.ini upload_max_filesize
UPLOAD_ERR_FORM_SIZE2超過表單 MAX_FILE_SIZE 隱藏欄位
UPLOAD_ERR_PARTIAL3僅部分上傳 (網路中斷)
UPLOAD_ERR_NO_FILE4沒有檔案上傳
UPLOAD_ERR_NO_TMP_DIR6缺少暫存目錄 (PHP 5.0.3+)
UPLOAD_ERR_CANT_WRITE7寫入磁碟失敗 (PHP 5.1.0+)
UPLOAD_ERR_EXTENSION8PHP 擴展中斷上傳 (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";
?>

關鍵安全點總結

  1. 永遠驗證 MIME 型別:用 finfo (Fileinfo 擴展) 而非 $_FILES['type']。
  2. 檔名隨機化:防止覆蓋、路徑遍歷、惡意副檔名執行。
  3. 儲存目錄不可執行 PHP**:Nginx/Apache 設定 uploads 目錄禁用腳本執行。
  4. 限制大小:php.ini upload_max_filesize, post_max_size + 程式碼雙重檢查。
  5. 掃描惡意內容:整合 ClamAV、VirusTotal API 等。
  6. 資料庫記錄元資料:原始檔名、儲存路徑、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];
    // ... 單檔驗證邏輯 ...
}
?>
copyright © 萬盛學電腦網 all rights reserved