萬盛學電腦網

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

PHP + AJAX 無刷新上傳圖片完整實例 (傳統 XMLHttpRequest 版)

早期 AJAX 上傳需手動構造 multipart/form-data 請求體,現代建議用 FormData + fetch/axios。本文保留原始手動構造版本供教學參考,並提供現代寫法對照。

目錄結構

project/
├── index.html   # 前端頁面
└── upload.php   # 後端處理

1. 前端 index.html (原始手動構造版)

<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>AJAX 上傳示例</title></head><body>
<h1>Ajax file upload sample</h1>
<input type="button" id="btn_send" value="上傳測試">
<div id="result"></div>

<script>
// 手動構造 multipart/form-data (僅教學用,生產請用 FormData)
document.getElementById('btn_send').onclick = function() {
  var boundary = '-------7d8d733180846';
  var data = '';
  data += '--' + boundary + '\r\n';
  data += 'Content-Disposition: form-data; name="photofile"; filename="a.txt"\r\n';
  data += 'Content-Type: text/plain\r\n\r\n';
  var text = 'My name is Wilson Lin.';
  data += text + '\r\n';
  data += '--' + boundary + '--\r\n';

  var xhr = new XMLHttpRequest(); // 現代瀏覽器通用
  xhr.open('POST', './upload.php', true);
  xhr.setRequestHeader('Content-Type', 'multipart/form-data; boundary=' + boundary);
  xhr.setRequestHeader('Content-Length', data.length);
  xhr.onload = function() {
    document.getElementById('result').innerHTML = xhr.responseText;
  };
  xhr.send(data);
};
</script>
</body></html>

2. 後端 upload.php

<?php
// 簡單演示:直接複製暫存檔到 D:/ (Windows 路徑,Linux 請改)
$uploadDir = 'D:/'; // 請確保目錄存在且可寫
$name = basename($_FILES['photofile']['name']);
$target = $uploadDir . $name;

if (move_uploaded_file($_FILES['photofile']['tmp_name'], $target)) {
    echo "URL: <a href='https://localhost/$name' target='_blank'>$name</a><br/>";
    echo "Upload successed!";
} else {
    echo "Upload failed: " . $_FILES['photofile']['error'];
}

現代最佳實踐 (推薦)

// 前端
const formData = new FormData();
formData.append('photofile', fileInput.files[0]);
fetch('./upload.php', { method: 'POST', body: formData })
  .then(r => r.text())
  .then(html => resultDiv.innerHTML = html);

// 後端 $_FILES 用法完全相容,無需改動

關鍵點提醒

  • enctype="multipart/form-data" 只對 <form> 原生提交生效,AJAX 需手動設定 Header 或用 FormData 自動處理。
  • 手動構造邊界字串極易出錯 (換行、雙連字號、長度計算),生產環境嚴禁手動拼裝。
  • 後端必須驗證:檔案型別、大小、MIME、副檔名、掃毒、隨機重命名、存儲路徑非 Web 可直接訪問目錄。
  • 大檔案斷點續傳請用 tus.io、Uppy、Plupload 等成熟庫。
copyright © 萬盛學電腦網 all rights reserved