萬盛學電腦網

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

PHP 檔案上傳簡易範例:從表單到儲存的完整流程

最小可行上傳範例

<?php
// upload.php - 單檔案處理邏輯
function alert(string $msg): string {
    return '';
}

$allowedTypes = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
$uploadDir = __DIR__ . '/uploads/';
$maxSize = 2 * 1024 * 1024; // 2MB

if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    exit(alert('請透過表單提交'));
}

$file = $_FILES['file'] ?? null;
if (!$file || $file['error'] !== UPLOAD_ERR_OK) {
    exit(alert('上傳錯誤:' . ($file['error'] ?? '未知')));
}

if ($file['size'] > $maxSize) {
    exit(alert('檔案超過 ' . ($maxSize/1024/1024) . 'MB 限制'));
}

// 真實 MIME 驗證
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($file['tmp_name']);
if (!in_array($mime, $allowedTypes, true)) {
    exit(alert('僅允許 JPG/PNG/GIF/WebP 圖片'));
}

// 確保目錄存在
if (!is_dir($uploadDir) && !mkdir($uploadDir, 0755, true)) {
    exit(alert('無法建立上傳目錄'));
}

// 產生唯一檔名
$ext = ['image/jpeg'=>'jpg','image/png'=>'png','image/gif'=>'gif','image/webp'=>'webp'][$mime];
$filename = date('YmdHis') . '_' . bin2hex(random_bytes(8)) . '.' . $ext;
$destPath = $uploadDir . $filename;

// 移動檔案
if (!move_uploaded_file($file['tmp_name'], $destPath)) {
    exit(alert('檔案儲存失敗'));
}

// 成功
echo alert('上傳成功:' . $filename);
?>

HTML 表單 (index.html)




    
    檔案上傳
    


    

圖片上傳

支援拖曳上傳

關鍵點解析

  1. enctype="multipart/form-data":表單必須設定,否則 $_FILES 為空
  2. $_FILES['file']['error']:第一道防線,檢查上傳過程錯誤
  3. finfo 驗證 MIME:不信任瀏覽器提供的 $_FILES['type']
  4. move_uploaded_file():唯一安全移動上傳檔案的函式,會驗證是否為真實上傳檔
  5. 隨機檔名:避免衝突、路徑遍歷、惡意副檔名執行
  6. 上傳目錄權限:Web 使用者可寫入,但不可執行 PHP

進階:顯示上傳結果與預覽

<?php
// upload.php 成功後改為顯示頁面而非 alert
if (move_uploaded_file($file['tmp_name'], $destPath)) {
    $fileUrl = '/uploads/' . $filename;
?>


上傳成功

    

上傳成功!

檔名:

大小: KB

類型:

預覽

繼續上傳

常見問題排查

現象可能原因解決
$_FILES 為空表單缺 enctype、檔案超過 post_max_size檢查表單、調大 php.ini 設定
move_uploaded_file 失敗目錄權限、磁碟空間、open_basedir 限制chmod 755、檢查錯誤日誌
上傳後無法顯示Nginx/Apache 未設定靜態檔案服務、路徑錯誤確認 web root、URL 重寫規則
中文檔名亂碼檔案系統編碼、URL 編碼不一致強制使用隨機檔名

擴充建議

  • 拖曳上傳:ondrop 事件 + FormData AJAX
  • 進度條:XMLHttpRequest upload.onprogress
  • 圖片壓縮:瀏覽器端 canvas.toBlob() 壓縮後再上傳
  • 雲端儲存:簽名 URL 直傳 S3/GCS,減輕伺服器負載
copyright © 萬盛學電腦網 all rights reserved