萬盛學電腦網

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

PHP 文件上傳完整實戰:從基礎流程到安全加固

上傳流程核心步驟

  1. HTML 表單設置 enctype="multipart/form-data"、method="POST"、input type="file"。
  2. PHP 通過 $_FILES['field_name'] 超全局數組獲取文件元數據。
  3. 服務端驗證:錯誤碼、文件類型、大小、MIME 欺騙、文件名安全。
  4. 移動臨時文件至目標目錄:move_uploaded_file()。
  5. 業務邏輯處理:重命名、入庫、生成縮略圖、病毒掃描等。

關鍵變量 $_FILES 結構

鍵名含義示例
name客戶端原始文件名avatar.png
type瀏覽器報告的 MIME 類型(不可信)image/png
size文件大小(字節)102400
tmp_name服務器臨時存儲路徑/tmp/phpA1B2C3
error錯誤代碼 (0=成功)UPLOAD_ERR_OK (0)

錯誤碼對照

UPLOAD_ERR_OK            = 0  // 成功
UPLOAD_ERR_INI_SIZE      = 1  // 超過 php.ini upload_max_filesize
UPLOAD_ERR_FORM_SIZE     = 2  // 超過表單 MAX_FILE_SIZE
UPLOAD_ERR_PARTIAL       = 3  // 部分上傳
UPLOAD_ERR_NO_FILE       = 4  // 未選擇文件
UPLOAD_ERR_NO_TMP_DIR    = 6  // 缺少臨時目錄
UPLOAD_ERR_CANT_WRITE    = 7  // 寫入磁盤失敗
UPLOAD_ERR_EXTENSION     = 8  // PHP 擴展阻止上傳

基礎上傳腳本 (upload.php)

<?php
// 配置
$uploadDir = __DIR__ . '/uploads/';
$maxSize   = 2 * 1024 * 1024; // 2MB
$allowedMimes = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
$allowedExts  = ['jpg', 'jpeg', 'png', 'gif', 'webp'];

if (!isset($_FILES['myfile']) || $_FILES['myfile']['error'] !== UPLOAD_ERR_OK) {
    $errCode = $_FILES['myfile']['error'] ?? UPLOAD_ERR_NO_FILE;
    exit(json_encode(['code' => $errCode, 'msg' => '上傳失敗: ' . uploadErrorMsg($errCode)]));
}

$file = $_FILES['myfile'];

// 1. 大小檢查
if ($file['size'] > $maxSize) {
    exit(json_encode(['code' => 400, 'msg' => '文件過大,限制 2MB']));
}

// 2. 擴展名檢查(二次防線)
$ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
if (!in_array($ext, $allowedExts, true)) {
    exit(json_encode(['code' => 400, 'msg' => '不支持的文件格式']));
}

// 3. MIME 類型檢查(finfo 真實檢測,防偽裝)
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($file['tmp_name']);
if (!in_array($mime, $allowedMimes, true)) {
    exit(json_encode(['code' => 400, 'msg' => '文件內容類型不合法']));
}

// 4. 生成安全文件名:時間戳 + 隨機數 + 原始擴展名
$newName = sprintf('%s_%s.%s', date('YmdHis'), bin2hex(random_bytes(8)), $ext);
$destPath = $uploadDir . $newName;

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

// 6. 移動文件(move_uploaded_file 會檢查是否為真實上傳文件)
if (!move_uploaded_file($file['tmp_name'], $destPath)) {
    exit(json_encode(['code' => 500, 'msg' => '文件保存失敗']));
}

// 7. 可選:設置文件權限、生成縮略圖、寫入數據庫...
chmod($destPath, 0644);

echo json_encode([
    'code' => 0,
    'msg'  => '上傳成功',
    'data' => [
        'url'      => '/uploads/' . $newName,
        'name'     => $file['name'],
        'size'     => $file['size'],
        'mime'     => $mime,
    ]
]);

function uploadErrorMsg($code) {
    static $msgs = [
        UPLOAD_ERR_INI_SIZE     => '超過服務器限制',
        UPLOAD_ERR_FORM_SIZE    => '超過表單限制',
        UPLOAD_ERR_PARTIAL      => '上傳不完整',
        UPLOAD_ERR_NO_FILE      => '未選擇文件',
        UPLOAD_ERR_NO_TMP_DIR   => '服務器配置錯誤',
        UPLOAD_ERR_CANT_WRITE   => '寫入失敗',
        UPLOAD_ERR_EXTENSION    => '被擴展阻止',
    ];
    return $msgs[$code] ?? '未知錯誤';
}

HTML 表單模板

<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>文件上傳</title></head>
<body>
<form action="upload.php" method="post" enctype="multipart/form-data" id="uploadForm">
    <input type="hidden" name="MAX_FILE_SIZE" value="2097152"> <!-- 2MB,客戶端提示用,不可信 -->
    <div>
        <label>用戶名: <input type="text" name="username" required></label>
    </div>
    <div>
        <label>選擇圖片: <input type="file" name="myfile" accept="image/*" required></label>
    </div>
    <button type="submit">上傳</button>
</form>
<script>
document.getElementById('uploadForm').addEventListener('submit', async (e) => {
    e.preventDefault();
    const formData = new FormData(e.target);
    const res = await fetch('upload.php', {method: 'POST', body: formData});
    const json = await res.json();
    alert(json.msg + (json.data ? '\nURL: ' + json.data.url : ''));
});
</script>
</body></html>

進階安全加固清單

  1. 禁用腳本執行權限: 上傳目錄配置 Nginx/Apache 禁止 PHP/腳本執行。
    # Nginx
    location /uploads/ {
        location ~ \.php$ { deny all; return 403; }
    }
    
    # Apache .htaccess
    <FilesMatch "\.php$">
        Require all denied
    </FilesMatch>
  2. 文件名去標識化: 不使用原始文件名,防止路徑遍歷(../../etc/passwd)、特殊字符注入、中文編碼問題。
  3. 內容檢測: finfo 檢測真實 MIME;圖片用 getimagesize() 驗證真實尺寸;視頻/文檔可接入 ClamAV 病毒掃描。
  4. 限制並發與總量: Redis 計數器限制用戶每分鐘上傳次數、每日總大小。
  5. 分離存儲: 生產環境使用對象存儲(OSS/S3/MinIO),Web 服務器無寫入權限,通過預簽名 URL 直傳。
  6. 圖片二次渲染: GD/Imagick 讀取並重新保存,剝離潛在的圖片馬(polyglot)。

大文件分片上傳(斷點續傳)架構

  1. 前端:SparkMD5 計算文件 Hash,按 5MB 分片。
  2. 上傳前請求 /api/upload/check?hash=xxx 秒傳/斷點檢查。
  3. 逐片上傳 /api/upload/chunk,參數:hash, index, chunk。
  4. 服務端:臨時目錄保存分片,合併驗證 Hash 後移至正式目錄。
  5. 推薦成熟庫:plupload、uppy、webuploader(前端);PHP 端參考 league/flysystem 存儲抽象。
copyright © 萬盛學電腦網 all rights reserved