萬盛學電腦網

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

PHP 多檔案上傳完整實作:HTML 表單、後端處理、安全性檢查

前言

多檔案上傳的關鍵在於 HTML 表單的 name="files[]" 陣列命名,以及後端遍歷 $_FILES 陣列逐一處理。本文提供完整、安全、可直接部署的實作範例。

HTML 表單

<!DOCTYPE html>
<html lang="zh-Hant">
<head>
  <meta charset="UTF-8">
  <title>多檔案上傳</title>
  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body class="bg-light">
  <div class="container py-5">
    <div class="card shadow">
      <div class="card-header bg-primary text-white"><h4>批量檔案上傳</h4></div>
      <div class="card-body">
        <form action="upload_multiple.php" method="post" enctype="multipart/form-data" id="uploadForm">
          <div class="mb-3">
            <label class="form-label">選擇多個檔案(按住 Ctrl/Shift 多選)</label>
            <input type="file" name="files[]" id="fileInput" class="form-control" multiple required>
            <div class="form-text">支援:jpg, png, gif, pdf, docx,單檔限制 5MB</div>
          </div>
          <button type="submit" name="submit" class="btn btn-success">開始上傳</button>
          <div id="result" class="mt-3"></div>
        </form>
      </div>
    </div>
  </div>
</body>
</html>

後端處理

<?php
// upload_multiple.php
declare(strict_types=1);

const UPLOAD_DIR = __DIR__ . '/uploads/';
const MAX_FILE_SIZE = 5 * 1024 * 1024; // 5MB
const ALLOWED_MIME = [
    'image/jpeg', 'image/png', 'image/gif', 'image/webp',
    'application/pdf',
    'application/msword',
    'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
];
const ALLOWED_EXT = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'pdf', 'doc', 'docx'];

// 確保上傳目錄存在且可寫
if (!is_dir(UPLOAD_DIR)) {
    mkdir(UPLOAD_DIR, 0755, true);
}
if (!is_writable(UPLOAD_DIR)) {
    http_response_code(500);
    exit(json_encode(['success' => false, 'message' => '上傳目錄不可寫入']));
}

header('Content-Type: application/json; charset=utf-8');

if ($_SERVER['REQUEST_METHOD'] !== 'POST' || empty($_FILES['files'])) {
    http_response_code(400);
    exit(json_encode(['success' => false, 'message' => '無效請求']));
}

$results = [];
$files = $_FILES['files'];

// 整理 $_FILES 陣列結構:從平行陣列轉為逐檔案陣列
$fileCount = count($files['name']);
$normalized = [];
for ($i = 0; $i < $fileCount; $i++) {
    $normalized[] = [
        'name'     => $files['name'][$i],
        'type'     => $files['type'][$i],
        'tmp_name' => $files['tmp_name'][$i],
        'error'    => $files['error'][$i],
        'size'     => $files['size'][$i],
    ];
}

foreach ($normalized as $index => $file) {
    $result = ['original_name' => $file['name']];

    // 1. 檢查上傳錯誤碼
    if ($file['error'] !== UPLOAD_ERR_OK) {
        $result['success'] = false;
        $result['message'] = match ($file['error']) {
            UPLOAD_ERR_INI_SIZE, UPLOAD_ERR_FORM_SIZE => '檔案超過大小限制',
            UPLOAD_ERR_PARTIAL => '檔案上傳不完整',
            UPLOAD_ERR_NO_FILE => '未選擇檔案',
            UPLOAD_ERR_NO_TMP_DIR => '伺服器臨時目錄缺失',
            UPLOAD_ERR_CANT_WRITE => '伺服器寫入失敗',
            UPLOAD_ERR_EXTENSION => 'PHP 擴充功能中斷上傳',
            default => '未知上傳錯誤',
        };
        $results[] = $result;
        continue;
    }

    // 2. 檢查檔案大小
    if ($file['size'] > MAX_FILE_SIZE) {
        $result['success'] = false;
        $result['message'] = '檔案大小超過 ' . (MAX_FILE_SIZE / 1024 / 1024) . 'MB 限制';
        $results[] = $result;
        continue;
    }

    // 3. 檢查 MIME 型別(需搭配 finfo 確認真實型別)
    $finfo = new finfo(FILEINFO_MIME_TYPE);
    $realMime = $finfo->file($file['tmp_name']);
    if (!in_array($realMime, ALLOWED_MIME, true)) {
        $result['success'] = false;
        $result['message'] = '檔案類型不允許(偵測為 ' . $realMime . ')';
        $results[] = $result;
        continue;
    }

    // 4. 檢查副檔名
    $ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
    if (!in_array($ext, ALLOWED_EXT, true)) {
        $result['success'] = false;
        $result['message'] = '副檔名不允許';
        $results[] = $result;
        continue;
    }

    // 5. 產生安全檔名:時間戳 + 隨機字串 + 原始副檔名
    $safeName = sprintf('%s_%s.%s', date('YmdHis'), bin2hex(random_bytes(8)), $ext);
    $destPath = UPLOAD_DIR . $safeName;

    // 6. 移動檔案
    if (!move_uploaded_file($file['tmp_name'], $destPath)) {
        $result['success'] = false;
        $result['message'] = '檔案儲存失敗(權限或磁碟空間不足)';
        $results[] = $result;
        continue;
    }

    // 成功
    $result['success'] = true;
    $result['saved_name'] = $safeName;
    $result['path'] = $destPath;
    $result['size'] = $file['size'];
    $result['mime'] = $realMime;
    $results[] = $result;
}

// 回傳結果
$successCount = count(array_filter($results, fn($r) => $r['success']));
echo json_encode([
    'success' => $successCount > 0,
    'total' => count($results),
    'success_count' => $successCount,
    'files' => $results,
], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
?>

前端 AJAX 體驗優化(選配)

<script>
document.getElementById('uploadForm').addEventListener('submit', async (e) => {
    e.preventDefault();
    const formData = new FormData(e.target);
    const resultDiv = document.getElementById('result');
    resultDiv.innerHTML = '<div class="text-center"><div class="spinner-border"></div> 上傳中...</div>';

    try {
        const res = await fetch('upload_multiple.php', { method: 'POST', body: formData });
        const data = await res.json();
        renderResult(data);
    } catch (err) {
        resultDiv.innerHTML = '<div class="alert alert-danger">網路錯誤:' + err.message + '</div>';
    }
});

function renderResult(data) {
    const div = document.getElementById('result');
    if (data.success) {
        let html = '<div class="alert alert-success">成功上傳 ' + data.success_count + ' / ' + data.total + ' 個檔案</div>';
        html += '<ul class="list-group">';
        data.files.forEach(f => {
            const badge = f.success ? 'success' : 'danger';
            html += `<li class="list-group-item d-flex justify-content-between">
                <span>${f.original_name}</span>
                <span class="badge bg-${badge}">${f.success ? '成功' : '失敗: ' + f.message}</span>
            </li>`;
        });
        html += '</ul>';
        div.innerHTML = html;
    } else {
        div.innerHTML = '<div class="alert alert-danger">' + (data.message || '上傳失敗') + '</div>';
    }
}
</script>

安全性檢查清單

  1. ✅ 限制 MIME 型別與副檔名雙重檢查
  2. ✅ 使用 finfo 偵測真實檔案型別,防止偽裝副檔名
  3. ✅ 重新命名檔案,避免覆蓋、路徑遍歷、特殊字元問題
  4. ✅ 限制單檔大小與總上傳大小(php.ini upload_max_filesize, post_max_size)
  5. ✅ 上傳目錄設定 php_flag engine off 或放在 Web Root 外,防止直接執行上傳的腳本
  6. ✅ 設定 Content-Security-Policy、X-Content-Type-Options: nosniff

總結

多檔案上傳的核心是 name="files[]" + multiple 屬性,後端以 $_FILES['files'] 陣列結構遍歷處理。配合 MIME 檢查、隨機檔名、權限隔離,即可構建安全可靠的上傳功能。

copyright © 萬盛學電腦網 all rights reserved