萬盛學電腦網

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

PHP 檔案上傳最簡易實作範例

最基礎的 PHP 檔案上傳處理流程:表單建構、上傳驗證、移動檔案、錯誤處理。適合快速原型與學習參考。

HTML 表單(必要屬性)

<form action="upload.php" method="post" enctype="multipart/form-data">
    <input type="file" name="ufile" required>
    <button type="submit">上傳</button>
</form>

關鍵點:

  • method="post" — 檔案必須用 POST
  • enctype="multipart/form-data" — 瀏覽器才會正確編碼檔案內容
  • name="ufile" — 對應 $_FILES['ufile']

PHP 處理腳本 upload.php

<?php
// 設定上傳目錄(需可寫入權限)
define('UPLOAD_DIR', __DIR__ . '/uploads/');

if (!is_dir(UPLOAD_DIR)) {
    mkdir(UPLOAD_DIR, 0755, true);
}

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // 1. 檢查是否有檔案上傳
    if (empty($_FILES['ufile']) || $_FILES['ufile']['error'] !== UPLOAD_ERR_OK) {
        $error_code = $_FILES['ufile']['error'] ?? UPLOAD_ERR_NO_FILE;
        $messages = [
            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 => '檔案寫入失敗',
            UPLOAD_ERR_EXTENSION  => '被 PHP 延伸模組阻擋',
        ];
        die('上傳失敗:' . ($messages[$error_code] ?? "未知錯誤 ($error_code)"));
    }
    
    $file = $_FILES['ufile'];
    $tmp_name = $file['tmp_name'];
    $orig_name = basename($file['name']);
    
    // 2. 安全處理檔名:防止路徑遍歷、覆蓋、特殊字元
    $ext = strtolower(pathinfo($orig_name, PATHINFO_EXTENSION));
    $allowed_ext = ['jpg', 'jpeg', 'png', 'gif', 'pdf', 'txt', 'doc', 'docx'];
    
    if (!in_array($ext, $allowed_ext, true)) {
        die('不允許的檔案類型:' . htmlspecialchars($ext));
    }
    
    // 產生唯一檔名:時間戳 + 隨機字串 + 原始副檔名
    $new_name = date('Ymd_His') . '_' . bin2hex(random_bytes(8)) . '.' . $ext;
    $dest_path = UPLOAD_DIR . $new_name;
    
    // 3. 驗證是否真為上傳檔案(防偽造)
    if (!is_uploaded_file($tmp_name)) {
        die('非法上傳嘗試');
    }
    
    // 4. 移動檔案
    if (!move_uploaded_file($tmp_name, $dest_path)) {
        die('檔案移動失敗,請檢查目錄權限');
    }
    
    // 5. 成功回應
    echo "上傳成功!
"; echo "原始檔名:", htmlspecialchars($orig_name), "
"; echo "儲存路徑:", htmlspecialchars($dest_path), "
"; echo "檔案大小:", number_format($file['size'] / 1024, 2), " KB
"; echo '<a href="uploads/' . urlencode($new_name) . '" target="_blank">檢視檔案</a>'; // 記錄日誌(可選) error_log(sprintf('UPLOAD: %s -> %s (%.2f KB)', $orig_name, $new_name, $file['size']/1024)); } ?>

關鍵安全檢查點

檢查項目目的實作方式
錯誤代碼檢查攔截上傳失敗$_FILES['ufile']['error'] === UPLOAD_ERR_OK
副檔名白名單防惡意腳本上傳in_array($ext, $allowed, true)
MIME 型態驗證雙重保險finfo_file(finfo_open(FILEINFO_MIME_TYPE), $tmp_name)
檔案大小限制防止佔滿磁碟$file['size'] <= 5 * 1024 * 1024 (5MB)
檔名安全化防路徑遍歷、覆蓋重新命名、basename()、移除特殊字元
is_uploaded_file()確認檔案確實經由 HTTP POST 上傳防止本地檔案讀取攻擊
上傳目錄權限最小權限原則chmod 755、不可執行、設 open_basedir
Web 可存取隔離防直接執行上傳的 PHP 腳本上傳目錄設 php_flag engine off 或放在 Webroot 外

多檔案上傳

<input type="file" name="ufiles[]" multiple>

<?php
foreach ($_FILES['ufiles']['tmp_name'] as $idx => $tmp_name) {
    if ($_FILES['ufiles']['error'][$idx] !== UPLOAD_ERR_OK) continue;
    
    $orig_name = $_FILES['ufiles']['name'][$idx];
    // ... 單檔處理邏輯 ...
}

進階:分塊上傳/大檔案/斷點續傳

簡易版不支援大檔案(受限 post_max_size、upload_max_filesize、記憶體、執行時間)。生產環境大檔案建議:

  • 前端切片:File.prototype.slice() + spark-md5 計算雜湊
  • 後端合併:暫存分片 → 全部上傳完成 → 合併 → 驗證雜湊
  • 現成方案:Uppy + tus.io、Dropzone.js、FilePond、WebUploader

掌握基礎上傳流程後,請務必依照安全檢查點強化,再部署至生產環境。

copyright © 萬盛學電腦網 all rights reserved