萬盛學電腦網

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

PHP 檔案上傳完整教學:move_uploaded_file 實作與安全防護

前言

檔案上傳是 Web 開發常見功能,但也是安全風險高發區。本文從基礎 move_uploaded_file() 用法切入,完整示範上傳表單、後端處理、檔案驗證、隨機命名、錯誤處理與安全防護要點。

核心函數說明

bool move_uploaded_file(string $filename, string $destination)
/*
參數:
$filename  - $_FILES['file']['tmp_name'] 暫存檔路徑
$destination - 目標儲存完整路徑(含檔名)
回傳:成功 true、失敗 false
注意:僅限 HTTP POST 上傳檔案,目標檔案存在會被覆蓋
*/

完整上傳範例(含前端表單)

1. HTML 表單(upload.html)

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>PHP 檔案上傳範例</title>
</head>
<body>
    <form action="upload.php" method="post" enctype="multipart/form-data">
        <input type="hidden" name="MAX_FILE_SIZE" value="2000000"> <!-- 限制 2MB -->
        <input type="file" name="userfile" accept="image/*,.pdf,.txt">
        <input type="submit" value="上傳檔案">
    </form>
</body>
</html>

2. 後端處理(upload.php)

<?php
// 設定上傳目錄(需可寫入權限)
$uploadDir = __DIR__ . '/uploads/';
if (!is_dir($uploadDir)) {
    mkdir($uploadDir, 0755, true);
}

// 檢查是否為 POST 請求且有檔案上傳
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['userfile'])) {
    $file = $_FILES['userfile'];
    
    // 1. 基礎錯誤檢查
    if ($file['error'] !== UPLOAD_ERR_OK) {
        $errors = [
            UPLOAD_ERR_INI_SIZE   => '檔案超過 php.ini upload_max_filesize',
            UPLOAD_ERR_FORM_SIZE  => '檔案超過表單 MAX_FILE_SIZE',
            UPLOAD_ERR_PARTIAL    => '檔案僅部分上傳',
            UPLOAD_ERR_NO_FILE    => '未選擇檔案',
            UPLOAD_ERR_NO_TMP_DIR => '缺少暫存目錄',
            UPLOAD_ERR_CANT_WRITE => '寫入磁碟失敗',
        ];
        die('上傳錯誤: ' . ($errors[$file['error']] ?? '未知錯誤'));
    }

    // 2. 檔案類型驗證(建議同時驗證 MIME 與副檔名)
    $allowedMimes = ['image/jpeg', 'image/png', 'image/gif', 'application/pdf', 'text/plain'];
    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    $mime  = finfo_file($finfo, $file['tmp_name']);
    finfo_close($finfo);
    
    if (!in_array($mime, $allowedMimes, true)) {
        die('不允許的檔案類型: ' . $mime);
    }

    // 3. 產生安全檔名:隨機字串 + 原始副檔名
    $ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
    $newName = bin2hex(random_bytes(16)) . '.' . $ext;
    $destPath = $uploadDir . $newName;

    // 4. 移動檔案
    if (move_uploaded_file($file['tmp_name'], $destPath)) {
        echo "上傳成功!檔案儲存為: {$newName}";
        // 可在此寫入資料庫記錄:原始檔名、儲存檔名、MIME、大小、上傳時間等
    } else {
        echo '上傳失敗:無法移動檔案';
    }
} else {
    echo '請透過表單上傳檔案';
}
?>

安全防護關鍵點

  1. 驗證 MIME 類型:使用 finfo_file() 而非依賴 $_FILES['type'](可偽造)
  2. 限制副檔名:僅允許白名單副檔名,避免上傳 .php、.phtml 等可執行腳本
  3. 隨機化檔名:防止檔名衝突、路徑遍歷攻擊、資訊洩露
  4. 儲存目錄不可直接執行腳本:Nginx/Apache 設定上傳目錄禁用 PHP 執行
  5. 限制檔案大小:php.ini upload_max_filesize、post_max_size、表單 MAX_FILE_SIZE 三層防護
  6. 掃描惡意內容:生產環境建議整合 ClamAV 或雲端病毒掃描 API

常見問題排查

現象可能原因解決方向
$_FILES 為空表單缺少 enctype、檔案過大、php.ini 關閉上傳檢查表單屬性、調整 php.ini 設定
move_uploaded_file 回傳 false目錄權限不足、磁碟空間不足、open_basedir 限制確認目錄可寫、檢查錯誤日誌
上傳大檔案失敗超過 post_max_size、max_execution_time、memory_limit調整 php.ini、考慮分片上傳

進階延伸

  • 多檔案上傳:<input type="file" name="files[]" multiple> 配合迴圈處理
  • 拖拉上傳:結合 JavaScript File API + FormData 異步上傳
  • 斷點續傳:大檔案切片上傳,服務端合併(如 WebUploader、Uppy)
  • 雲端儲存:直接上傳至 AWS S3、阿里雲 OSS、Google Cloud Storage
copyright © 萬盛學電腦網 all rights reserved