萬盛學電腦網

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

PHP 檔案上傳完整指南:原理、實作與安全設定

檔案上傳核心流程

  1. 表單 enctype="multipart/form-data" + method="POST"
  2. 使用者選擇檔案,瀏覽器送出
  3. PHP 將暫存檔移至指定目錄(move_uploaded_file)
  4. 驗證檔案類型、大小、完整性

關鍵要素

1. 表單設定

<form action="upload.php" method="post" enctype="multipart/form-data">
  <input type="hidden" name="MAX_FILE_SIZE" value="2000000">
  <input type="file" name="userfile">
  <input type="submit" value="上傳">
</form>
  • enctype="multipart/form-data":必須,讓伺服器識別二進位檔案資料。
  • MAX_FILE_SIZE:客戶端限制(可被繞過),伺服端仍需驗證。

2. $_FILES 超全域陣列

鍵名說明
name客戶端原始檔名
typeMIME 類型(如 image/jpeg)
size檔案大小(位元組)
tmp_name伺服器暫存路徑
error錯誤代碼(0=成功,1=超過 php.ini 上限,2=超過表單上限,3=部分上傳,4=無檔案)

3. 核心函式

  • move_uploaded_file($tmp, $dest):將暫存檔移至目標路徑(必須使用此函式,確保安全)。
  • is_uploaded_file($tmp):確認檔案確為 HTTP 上傳。

完整上傳處理函式範例

<?php
function uploadFile($type, $name, $ext, $size, $error, $tmpName, $targetName, $uploadDir) {
    $MAX_SIZE = 2_000_000; // 2MB
    $ALLOWED_MIMES = ['image/jpeg', 'image/png', 'image/gif'];
    $ALLOWED_EXTS  = ['.jpg', '.jpeg', '.png', '.gif'];

    // 1. 確保上傳目錄存在且可寫
    if (!is_dir($uploadDir)) {
        if (!mkdir($uploadDir, 0755, true)) {
            die('無法建立上傳目錄');
        }
    }

    // 2. 基本驗證
    if ($size > $MAX_SIZE) die('檔案過大');
    if ($size === 0) die('請選擇檔案');
    if (!in_array($type, $ALLOWED_MIMES) || !in_array(strtolower($ext), $ALLOWED_EXTS)) {
        die('不允許的檔案類型');
    }

    $targetPath = $uploadDir . '/' . $targetName;

    // 3. 移動檔案
    if (!move_uploaded_file($tmpName, $targetPath)) {
        die('檔案移動失敗');
    }

    // 4. 錯誤代碼處理
    switch ($error) {
        case 0: return true;
        case 1: die('超過 php.ini upload_max_filesize');
        case 2: die('超過表單 MAX_FILE_SIZE');
        case 3: die('檔案部分上傳');
        case 4: die('未上傳檔案');
        default: die('未知錯誤');
    }
}
?>

多檔案上傳

表單 name="files[]" 多個 <input type="file" name="files[]">,PHP 端 $_FILES['files']['name'][0] 為第一個檔案,以此類推。

大檔案上傳 php.ini 關鍵設定

指令建議值說明
file_uploadsOn啟用 HTTP 上傳
upload_max_filesize32M單一檔案上限
post_max_size32MPOST 總資料上限(必須 ≥ upload_max_filesize)
max_execution_time600腳本最長執行秒數
max_input_time600接收資料最長秒數
memory_limit128M腳本記憶體上限
upload_tmp_dir/tmp暫存目錄(需可寫)

安全最佳實務

  • ✅ 使用 move_uploaded_file() 而非 copy() 或 rename()。
  • ✅ 驗證 MIME 類型與副檔名(雙重檢查)。
  • ✅ 以隨機檔名儲存,避免覆蓋或路徑遍歷攻擊。
  • ✅ 上傳目錄設為不可執行腳本(Nginx/Apache 設定)。
  • ✅ 掃描病毒/惡意內容(如 ClamAV)。
  • ❌ 不要信任 $_FILES['type'],可用 finfo_file() 偵測真實 MIME。

檔案上傳看似簡單,實則涉及安全、效能、相容性多重考量,建議封裝為可復用的上傳服務類別。

copyright © 萬盛學電腦網 all rights reserved