萬盛學電腦網

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

PHP + iframe 實現無刷新檔案上傳 (經典相容方案)

在 FormData 普及前,利用隱藏 <iframe> 作為表單 target 是實現「無刷新上傳」的主流跨瀏覽器方案。原理:表單提交後,伺服器回傳一段 <script> 呼叫父頁面 JS 函數顯示結果。

前端 index.html

<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>無刷新上傳</title>
<script>
function startUpload() {
  document.getElementById('processing').innerHTML = 'loading...';
  return true; // 允許表單提交
}
function stopUpload(result) {
  var msg = {
    0: '上傳成功',
    1: '檔案超過大小限制',
    2: '只能上傳圖片檔案',
    '-1': '上傳失敗'
  }[result] || '未知錯誤';
  document.getElementById('processing').innerHTML = msg;
}
</script></head><body>
<div style="text-align:center">
  <div id="processing"></div>
  <form action="upload.php" method="post" enctype="multipart/form-data" target="form-target" onsubmit="return startUpload();">
    <input type="hidden" name="MAX_FILE_SIZE" value="1000000"> <!-- 1MB -->
    <input type="file" name="myfile">
    <input type="submit" name="sub" value="upload">
  </form>
  <iframe name="form-target" style="width:0;height:0;border:0;"></iframe>
</div></body></html>

後端 upload.php

<?php
sleep(2); // 模擬處理延遲
$allowed = ['jpg','png','gif','bmp'];
$uploadDir = __DIR__ . '/upfiles';
$maxSize = 1 * 1024 * 1024; // 1MB
$result = -1;

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_POST['sub'])) {
  $file = $_FILES['myfile'];
  $ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));

  if ($file['size'] > $maxSize) {
    $result = 1;
  } elseif (!in_array($ext, $allowed)) {
    $result = 2;
  } elseif (is_uploaded_file($file['tmp_name'])) {
    $target = $uploadDir . '/' . basename($file['name']);
    if (@move_uploaded_file($file['tmp_name'], $target)) {
      $result = 0;
    }
  }
}
?>
<script>window.top.window.stopUpload(<?= $result ?>);</script>

原理圖解

  1. 使用者點選檔案、按「upload」。
  2. 表單提交到隱藏 iframe,主頁不刷新。
  3. upload.php 處理上傳,輸出 <script>window.top.window.stopUpload(0);</script>。
  4. iframe 執行該腳本,呼叫父頁面 stopUpload() 更新 UI。

優缺點與現代替代

優點缺點
IE6+ 全瀏覽器相容
無需 JS 檔案讀取 API
簡單易懂
無法獲取上傳進度
錯誤處理麻煩 (需解析 iframe 內容)
安全性受同源策略限制
屬於 Hack 手段,非標準

現代專案請直接使用 FormData + fetch/XMLHttpRequest (支援 upload.onprogress 進度條),或成熟上傳庫 (Uppy, Dropzone, Plupload)。

copyright © 萬盛學電腦網 all rights reserved