萬盛學電腦網

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

PHP 檔案上傳完整原始碼:表單、處理、安全防護與現代最佳實踐

基礎版:最小可行上傳 (教學用)

1. 上傳表單 upfile.php

<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>檔案上傳</title></head>
<body>
<form action="upload.php" method="post" enctype="multipart/form-data">
    <input type="hidden" name="MAX_FILE_SIZE" value="2097152"> <!-- 2MB 客戶端提示 -->
    <input type="file" name="upfile" required><br><br>
    <button type="submit">上傳檔案</button>
</form>
</body></html>

2. 處理腳本 upload.php (含安全檢查)

<?php
// upload.php
$uploadDir = __DIR__ . '/uploads/';
if (!is_dir($uploadDir)) {
    mkdir($uploadDir, 0755, true);
}

// 1. 檢查上傳錯誤碼
if (!isset($_FILES['upfile']) || $_FILES['upfile']['error'] !== UPLOAD_ERR_OK) {
    $errors = [
        UPLOAD_ERR_INI_SIZE   => '超過 php.ini upload_max_filesize',
        UPLOAD_ERR_FORM_SIZE  => '超過表單 MAX_FILE_SIZE',
        UPLOAD_ERR_PARTIAL    => '檔案僅部分上傳',
        UPLOAD_ERR_NO_FILE    => '未選擇檔案',
        UPLOAD_ERR_NO_TMP_DIR => '缺少臨時目錄',
        UPLOAD_ERR_CANT_WRITE => '寫入磁碟失敗',
        UPLOAD_ERR_EXTENSION  => '被擴充模組中斷',
    ];
    die('上傳失敗: ' . ($errors[$_FILES['upfile']['error'] ?? '未知錯誤']));
}

$file = $_FILES['upfile'];

// 2. 基礎驗證
$maxSize = 2 * 1024 * 1024; // 2MB
if ($file['size'] > $maxSize) {
    die('檔案過大,限制 2MB');
}

// 3. MIME 型別白名單 (不要信任瀏覽器提供的 type,需自行檢測)
$allowedMimes = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($file['tmp_name']);
if (!in_array($mime, $allowedMimes, true)) {
    die('檔案類型不允許:' . $mime);
}

// 4. 副檔名白名單
$ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
$allowedExt = ['jpg', 'jpeg', 'png', 'gif', 'webp'];
if (!in_array($ext, $allowedExt, true)) {
    die('副檔名不允許');
}

// 5. 生成安全檔名 (避免覆蓋、路徑遍歷、中文亂碼)
$safeName = bin2hex(random_bytes(16)) . '.' . $ext; // 32 字元十六進位 + 副檔名
$destPath = $uploadDir . $safeName;

// 6. 移動檔案 (使用 move_uploaded_file 確保是合法上傳檔)
if (!move_uploaded_file($file['tmp_name'], $destPath)) {
    die('檔案移動失敗');
}

// 7. 成功回應
echo "上傳成功!
"; echo "原始檔名: " . htmlspecialchars($file['name']) . "
"; echo "儲存檔名: $safeName
"; echo "檔案大小: " . $file['size'] . " bytes
"; echo "MIME: $mime
"; if (str_starts_with($mime, 'image/')) { echo ""; } ?>

進階:多檔案上傳

<?php
// 表單:
$files = $_FILES['files'];
$count = count($files['name']);

for ($i = 0; $i < $count; $i++) {
    if ($files['error'][$i] !== UPLOAD_ERR_OK) continue;
    
    $tmpName = $files['tmp_name'][$i];
    $origName = $files['name'][$i];
    $size = $files['size'][$i];
    
    // 同樣驗證流程...
    $ext = strtolower(pathinfo($origName, PATHINFO_EXTENSION));
    $safeName = bin2hex(random_bytes(16)) . '.' . $ext;
    move_uploaded_file($tmpName, $uploadDir . $safeName);
    // 記錄資料庫...
}
?>

大檔案/斷點續傳:前端切片 + 後端合併

超過 PHP upload_max_filesize/post_max_size 或需斷點續傳時,採用前端切片 (如 uppy, dropzone, plupload) + 後端合併策略:

  1. 前端將檔案切割為 5MB 片段,並行上傳至 /upload/chunk。
  2. 後端接收片段儲存於臨時目錄 /tmp/uploads/{fileId}/part_{index}。
  3. 所有片段上傳完成,前端呼叫 /upload/merge。
  4. 後端按序合併片段 → 產生最終檔案 → 刪除臨時片段 → 入庫。

安全防護清單 (必檢項目)

風險防護措施
惡意腳本上傳 (.php, .phtml, .php5...)副檔名白名單 + MIME 檢測 + 儲存目錄禁用 PHP 解析 (Nginx location ~ \.php$ { deny all; })
檔名路徑遍歷 (../../../etc/passwd)捨棄原檔名,使用隨機生成檔名
檔案內容偽裝 (圖片夾帶 PHP 代碼)圖片重處理 imagecreatefromstring() 重新編碼、剝離 EXIF
DoS: 超大檔案佔滿磁碟/記憶體upload_max_filesize, post_max_size, MAX_FILE_SIZE, 磁碟配額
並發上傳衝突隨機檔名 (bin2hex(random_bytes(16))) 幾乎零衝突
敏感資訊洩露 (錯誤訊息含路徑)生產環境關閉 display_errors,記錄日誌不顯示用戶

現代框架整合 (Laravel / Symfony / Slim)

<?php
// Laravel Controller 範例
public function upload(Request $request)
{
    $request->validate([
        'file' => 'required|file|max:2048|mimes:jpg,jpeg,png,gif,webp|mimetypes:image/jpeg,image/png,image/gif,image/webp',
    ]);
    
    $path = $request->file('file')->store('uploads', 'public'); // 自動生成隨機名、存 public/storage/uploads
    
    return response()->json([
        'url' => Storage::url($path),
        'path' => $path,
    ]);
}
?>

結語

檔案上傳看似簡單,實則是安全攻擊面最集中的功能之一。**核心原則:不信任任何客戶端資料 (檔名、MIME、大小)、白名單驗證、隨機化儲存名稱、儲存目錄與 Web 根目錄隔離、禁用腳本執行權限**。現代框架已封裝完善,直接使用框架提供的上傳元件最安全高效。

copyright © 萬盛學電腦網 all rights reserved