萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JS + PHP 實現非同步拖曳上傳檔案完整範例

利用 HTML5 Drag & Drop API 搭配 FormData 與 XMLHttpRequest,配合 PHP 後端處理,可快速構建現代化拖曳上傳體驗。本文提供完整前後端代碼與關鍵點解析。

前端頁面 (upload.html)

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>拖曳上傳示例</title>
  <style>
    #dropZone { width:300px; height:200px; border:2px dashed #ccc; text-align:center; line-height:200px; color:#999; }
    #dropZone.dragOver { border-color:#007bff; background:#f0f8ff; color:#007bff; }
  </style>
</head>
<body>
  <div id="dropZone">請拖入檔案至此上傳</div>
  <script src="xhr-polyfill.js"></script> <!-- 兼容舊版 IE 的 XHR 封裝 -->
  <script>
    var dropZone = document.getElementById('dropZone');

    ['dragenter', 'dragover', 'dragleave', 'drop'].forEach(function(evt) {
      dropZone.addEventListener(evt, preventDefaults, false);
    });
    function preventDefaults(e) { e.preventDefault(); e.stopPropagation(); }

    ['dragenter', 'dragover'].forEach(function(evt) {
      dropZone.addEventListener(evt, function() { dropZone.classList.add('dragOver'); }, false);
    });
    ['dragleave', 'drop'].forEach(function(evt) {
      dropZone.addEventListener(evt, function() { dropZone.classList.remove('dragOver'); }, false);
    });

    dropZone.addEventListener('drop', handleDrop, false);

    function handleDrop(e) {
      var file = e.dataTransfer.files[0]; // 單檔示例,多檔請遍歷 files
      if (!file) return;

      var formData = new FormData();
      formData.append('file', file);

      var xhr = createXHR(); // 見下方兼容封裝
      xhr.open('POST', 'upload.php', true);

      xhr.upload.onprogress = function(e) {
        if (e.lengthComputable) {
          var percent = Math.round((e.loaded / e.total) * 100);
          dropZone.textContent = '上傳中 ' + percent + '%';
        }
      };

      xhr.onload = function() {
        if (xhr.status === 200) {
          dropZone.textContent = '上傳成功:' + xhr.responseText;
          dropZone.style.color = 'green';
        } else {
          dropZone.textContent = '上傳失敗:' + xhr.status;
          dropZone.style.color = 'red';
        }
      };

      xhr.onerror = function() {
        dropZone.textContent = '網路錯誤';
        dropZone.style.color = 'red';
      };

      xhr.send(formData);
    }

    // 兼容封裝:優先標準 XHR,回退 ActiveXObject
    function createXHR() {
      if (window.XMLHttpRequest) return new XMLHttpRequest();
      try { return new ActiveXObject('Msxml2.XMLHTTP'); } catch(e) {}
      try { return new ActiveXObject('Microsoft.XMLHTTP'); } catch(e) {}
      throw new Error('瀏覽器不支援 AJAX');
    }
  </script>
</body>
</html>

後端處理 (upload.php)

<?php
header('Content-Type: text/plain; charset=utf-8');

$targetDir = __DIR__ . '/uploads/';
if (!is_dir($targetDir)) mkdir($targetDir, 0755, true);

$inputName = 'file'; // 對應前端 formData.append('file', ...)
if (isset($_FILES[$inputName]) && $_FILES[$inputName]['error'] === UPLOAD_ERR_OK) {
  $tmpName = $_FILES[$inputName]['tmp_name'];
  $origName = basename($_FILES[$inputName]['name']);
  // 防止檔名衝突與安全風險:建議重命名
  $ext = pathinfo($origName, PATHINFO_EXTENSION);
  $newName = uniqid('upload_', true) . '.' . $ext;
  $destPath = $targetDir . $newName;

  if (move_uploaded_file($tmpName, $destPath)) {
    echo '檔案已儲存:' . $newName;
  } else {
    http_response_code(500);
    echo '移動檔案失敗';
  }
} else {
  http_response_code(400);
  echo '無效上傳:' . ($_FILES[$inputName]['error'] ?? '未收到檔案');
}

關鍵技術點總結

  1. Drag & Drop 事件流:dragenter/dragover 必須 preventDefault() 才能觸發 drop;drop 事件中透過 e.dataTransfer.files 取得 FileList。
  2. FormData:自動構建 multipart/form-data 請求體,支援二進位檔案直接上傳,無需 Base64 編碼。
  3. XHR 進度事件:xhr.upload.onprogress 即時顯示上傳進度,提升體驗。
  4. PHP 安全處理:驗證 $_FILES['error']、限制副檔名/MIME、重命名儲存、設定上傳目錄權限、防止腳本執行(.htaccess 禁用 PHP 解析)。
  5. 兼容性:IE10+ 完整支援;IE9 需用表單 + iframe 降級方案或 Flash 替代(現已極少見)。

擴充方向

  • 多檔案並行/序列上傳、斷點續傳(需後端支援分片合併)。
  • 客戶端圖片預覽(FileReader.readAsDataURL)、壓縮(Canvas 壓縮後再上傳)。
  • 整合雲存儲(AWS S3、阿里云 OSS)直傳,減輕應用伺服器頻寬壓力。

此範例展示了現代瀏覽器原生 API 搭配傳統 PHP 即可構建優雅的拖曳上傳功能,代碼簡潔、無第三方依賴,適合快速原型與中小專案直接採用。

copyright © 萬盛學電腦網 all rights reserved