萬盛學電腦網

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

PHP 文件上傳完整實戰:從表單構建到安全存儲

文件上傳是 Web 開發高頻需求,亦是安全重災區。本文從 HTML 表單規範、$_FILES 詳解、核心處理流程、安全加固四個維度構建生產級上傳方案。

HTML 表單必要條件

<form action="upload.php" method="POST" enctype="multipart/form-data">
  <input type="hidden" name="MAX_FILE_SIZE" value="33554432"> <!-- 32MB,瀏覽器端攔截 -->
  <input type="file" name="file" id="file" accept=".pdf,.jpg,.png">
  <input type="submit" value="上傳">
</form>
  • enctype="multipart/form-data":必須,否則 $_FILES 為空。
  • MAX_FILE_SIZE:瀏覽器端提示,非服務端強制,需後端二次校驗。
  • accept:限制文件類型,僅為 UX 輔助。

$_FILES 結構詳解

$_FILES['file'] = [
    'name'     => 'photo.jpg',      // 原始文件名(用戶可控,不可信)
    'type'     => 'image/jpeg',     // MIME 類型(瀏覽器推測,不可信)
    'tmp_name' => '/tmp/phpXyZ123', // 臨時存儲路徑(處理完自動刪除)
    'size'     => 204800,           // 字節大小
    'error'    => UPLOAD_ERR_OK     // 錯誤碼:0=成功,1=超過 php.ini upload_max_filesize,2=超過 MAX_FILE_SIZE,3=部分上傳,4=無文件,6=無臨時目錄
];

核心處理流程(安全版)

<?php
const UPLOAD_DIR = __DIR__ . '/uploads';
const ALLOWED_MIME = ['image/jpeg', 'image/png', 'application/pdf'];
const MAX_SIZE = 10 * 1024 * 1024; // 10MB

// 1. 基礎校驗
if (!isset($_FILES['file']) || $_FILES['file']['error'] !== UPLOAD_ERR_OK) {
    exit(json_encode(['code'=>400, 'msg'=> '上傳失敗或無文件']));
}
if ($_FILES['file']['size'] > MAX_SIZE) {
    exit(json_encode(['code'=>413, 'msg'=> '文件過大']));
}

// 2. MIME 類型二次校驗(使用 finfo,不可信 $_FILES['type'])
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($_FILES['file']['tmp_name']);
if (!in_array($mime, ALLOWED_MIME, true)) {
    exit(json_encode(['code'=>415, 'msg'=> '禁止的文件類型']));
}

// 3. 構建安全存儲名稱(防覆蓋、防路徑遍歷、防執行)
$ext = pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION);
$safeName = bin2hex(random_bytes(16)) . '.' . strtolower($ext);
$destPath = UPLOAD_DIR . '/' . date('Y/m/d') . '/' . $safeName;

// 4. 確保目錄存在
if (!is_dir(dirname($destPath))) {
    mkdir(dirname($destPath), 0755, true);
}

// 5. 移動文件(原子操作,跨分區自動複製+刪除)
if (!move_uploaded_file($_FILES['file']['tmp_name'], $destPath)) {
    exit(json_encode(['code'=>500, 'msg'=> '存儲失敗']));
}

// 6. 可選:圖片二次渲染(去除 EXIF、殘留腳本)
if (str_starts_with($mime, 'image/')) {
    $img = imagecreatefromstring(file_get_contents($destPath));
    imagejpeg($img, $destPath, 85);
    imagedestroy($img);
}

echo json_encode(['code'=>200, 'path'=> $destPath, 'url'=> '/uploads/' . date('Y/m/d') . '/' . $safeName]);

關鍵安全加固清單

  • ✅ 使用 finfo 驗證真實 MIME,而非 $_FILES['type']。
  • ✅ 重命名存儲(隨機名 + 白名單後綴),杜絕原始文件名注入。
  • ✅ 存儲目錄禁用腳本執行權限(Nginx: location ~* \.php$ { deny all; })。
  • ✅ 設置 open_basedir 限制 PHP 訪問範圍。
  • ✅ 病毒掃描集成:ClamAV clamscan 異步掃描。
  • ✅ 大文件分片上傳:前端切片,後端合併,避免超時與內存溢出。

結語

文件上傳「易學難精」。掌握 $_FILES 結構、move_uploaded_file 原子性、MIME 真實驗證、存儲路徑隨機化、目錄執行權限隔離,即可構建安全可靠的上傳服務。

copyright © 萬盛學電腦網 all rights reserved