萬盛學電腦網

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

PHP 檔案上傳完整指南:表單構建、$_FILES 詳解、多檔上傳與安全防護

一、HTML 上傳表單基礎

<form enctype="multipart/form-data" action="upload.php" method="post">
    <input type="hidden" name="MAX_FILE_SIZE" value="100000">
    <input name="userfile" type="file">
    <input type="submit" value="上傳檔案">
</form>

三大關鍵點

  1. enctype="multipart/form-data":必須,否則瀏覽器以 application/x-www-form-urlencoded 發送,伺服器無法解析檔案二進位資料。
  2. MAX_FILE_SIZE 隱藏欄位:僅為瀏覽器端建議,可被繞過,不可信任。真正限制在 PHP 端 upload_max_filesize。
  3. name="userfile":對應 $_FILES['userfile'] 索引鍵,可自訂。

二、PHP 端處理核心:$_FILES 超全域陣列

假設表單欄位名為 userfile:

鍵名含義範例
$_FILES['userfile']['name']客戶端原始檔名photo.jpg
$_FILES['userfile']['type']MIME 型別 (瀏覽器提供,不可信)image/jpeg
$_FILES['userfile']['size']檔案大小 (位元組)24578
$_FILES['userfile']['tmp_name']伺服器暫存檔完整路徑/tmp/phpA1B2C3
$_FILES['userfile']['error']錯誤代碼見下表

error 代碼對照表

值常數說明
0UPLOAD_ERR_OK上傳成功
1UPLOAD_ERR_INI_SIZE超過 php.ini upload_max_filesize
2UPLOAD_ERR_FORM_SIZE超過表單 MAX_FILE_SIZE
3UPLOAD_ERR_PARTIAL僅部分上傳 (網路中斷)
4UPLOAD_ERR_NO_FILE未選擇檔案
6UPLOAD_ERR_NO_TMP_DIR缺少暫存目錄 (PHP 5.0.3+)
7UPLOAD_ERR_CANT_WRITE寫入磁碟失敗 (PHP 5.1.0+)
8UPLOAD_ERR_EXTENSION擴展阻止上傳 (PHP 5.2.0+)

三、移動暫存檔至永久位置

<?php
$dest_dir = 'uploads/';
$dest = $dest_dir . date('Ymd') . '_' . basename($_FILES['userfile']['name']);

if (move_uploaded_file($_FILES['userfile']['tmp_name'], $dest)) {
    chmod($dest, 0644); // 設定檔案權限
    echo '上傳成功:' . $dest;
} else {
    echo '上傳失敗,錯誤碼:' . $_FILES['userfile']['error'];
}

必須使用 move_uploaded_file(),它會驗證檔案確實為 HTTP POST 上傳,防止偽造路徑攻擊。切勿用 copy() 或 rename()。

四、php.ini 關鍵上傳參數

指令預設建議生產值說明
file_uploadsOnOn總開關
upload_tmp_dir系統預設/var/tmp/php_upload暫存目錄,需可寫、獨立分區、設 noexec
upload_max_filesize2M50M單檔上限,需搭配 post_max_size
post_max_size8M60MPOST 總體大小,必須 ≥ upload_max_filesize
max_file_uploads2020單次請求最大檔案數 (PHP 5.2.1+)
max_input_time60300解析輸入資料最長秒數,大檔需調大

五、多檔案上傳實作

HTML:陣列命名法

<input type="file" name="files[]" multiple>
<!-- 或多個同名欄位 -->
<input type="file" name="files[]">
<input type="file" name="files[]">

PHP:遍歷處理

<?php
foreach ($_FILES['files']['tmp_name'] as $idx => $tmp_name) {
    if ($_FILES['files']['error'][$idx] !== UPLOAD_ERR_OK) continue;
    $name = basename($_FILES['files']['name'][$idx]);
    $dest = $dest_dir . date('YmdHis') . '_' . $idx . '_' . $name;
    move_uploaded_file($tmp_name, $dest);
}

六、安全防護清單 (必做)

  1. 檔案型別驗證:finfo_file() 檢測真實 MIME,禁用 $_FILES['type']。
  2. 副檔名白名單:僅允許 jpg|png|gif|pdf|docx 等。
  3. 重新命名:md5(uniqid()).'.'.$ext,避免覆蓋、路徑遍歷、腳本執行。
  4. 儲存目錄非 Web 可執行:放在 public_html 外,或設 nginx: location ~ \.php$ { deny all; }。
  5. 病毒掃描:整合 ClamAV clamscan 異步掃描。
  6. 限制尺寸與維度:getimagesize() 驗證圖片真實尺寸。

七、完整進階上傳類別範例 (節錄)

<?php
define('MAX_UPLOAD_FILES', 10);
define('MAX_FILE_SIZE', 5 * 1024 * 1024); // 5MB
define('UPLOAD_DIR', 'd:/uploads/');
$forbidden_ext = array('.php','.php3','.php4','.exe','.msi','.htaccess','.gz');

function safe_filename($name) {
    $ext = strtolower(pathinfo($name, PATHINFO_EXTENSION));
    $base = preg_replace('/[^a-z0-9_.-]/i', '_', pathinfo($name, PATHINFO_FILENAME));
    return $base . '.' . $ext;
}

if ($_POST['action'] === 'upload') {
    for ($i=1; $i<=MAX_UPLOAD_FILES; $i++) {
        $f = 'file_'.$i;
        if (!isset($_FILES[$f]) || $_FILES[$f]['error'] !== UPLOAD_ERR_OK) continue;
        if ($_FILES[$f]['size'] > MAX_FILE_SIZE) { /* 記錄錯誤 */ continue; }
        $ext = strtolower(pathinfo($_FILES[$f]['name'], PATHINFO_EXTENSION));
        if (in_array('.'.$ext, $forbidden_ext)) { /* 記錄錯誤 */ continue; }
        $new_name = safe_filename($_FILES[$f]['name']);
        move_uploaded_file($_FILES[$f]['tmp_name'], UPLOAD_DIR . $new_name);
        /* 記錄成功 */
    }
}

遵循「不信任客戶端、伺服器端二次驗證、最小權限儲存」原則,構建安全可靠的檔案上傳功能。

copyright © 萬盛學電腦網 all rights reserved