萬盛學電腦網

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

HTML5 FormData + PHP 實現無刷新表單提交與圖片上傳

FormData 核心優勢

FormData 物件可自動將表單所有 name/value 收集為 queryString,並原生支援 <input type="file"> 二進制上傳,配合 jQuery.ajax 即可實現無刷新提交,省去手動拼接參數的繁瑣工作。

兩種構建方式

方式一:手動 append

var formdata = new FormData();
formdata.append('name', 'fdipzone');
formdata.append('gender', 'male');

方式二:直接綁定表單 DOM(推薦)

<form id="form1">
    <input type="text" name="name" value="fdipzone">
    <input type="radio" name="gender" value="1"> 男
    <input type="radio" name="gender" value="2"> 女
    <input type="file" name="photo" id="photo">
</form>

var formdata = new FormData(document.getElementById('form1'));

完整 AJAX 提交範例

function fsubmit() {
    var data = new FormData($('#form1')[0]); // 必須取 [0] 轉為原生 DOM
    $.ajax({
        url: 'server.php',
        type: 'POST',
        data: data,
        dataType: 'JSON',
        cache: false,
        processData: false,  // 關鍵:禁止 jQuery 處理數據
        contentType: false   // 關鍵:禁止設置 Content-Type,讓瀏覽器自動帶上 boundary
    }).done(function(ret) {
        if (ret.isSuccess) {
            $('#result').html(
                'name=' + ret.name + '<br>' +
                'gender=' + ret.gender + '<br>' +
                '<img src="' + ret.photo + '" width="100">'
            );
        } else {
            alert('提交失敗');
        }
    });
    return false;
}

PHP 端處理 server.php

<?php
$name   = isset($_POST['name']) ? $_POST['name'] : '';
$gender = isset($_POST['gender']) ? $_POST['gender'] : '';

// 處理上傳檔案
$ext = substr($_FILES['photo']['name'], strrpos($_FILES['photo']['name'], '.'));
$filename = time() . $ext; // 簡單防重命名

$response = ['isSuccess' => false];
if (move_uploaded_file($_FILES['photo']['tmp_name'], $filename)) {
    $response = [
        'isSuccess' => true,
        'name'      => $name,
        'gender'    => $gender,
        'photo'     => $filename
    ];
}
echo json_encode($response);
?>

常見坑點提醒

  • processData: false 與 contentType: false 必須同時設置,否則檔案上傳失敗
  • 表單必須包含 enctype="multipart/form-data"(HTML5 FormData 會自動處理,但原生 form 提交仍需聲明)
  • PHP 端 $_FILES 只有在 POST 且 Content-Type: multipart/form-data 時才會填充
  • 生產環境請加入檔案類型、大小驗證,防止惡意上傳
copyright © 萬盛學電腦網 all rights reserved