萬盛學電腦網

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

PHP 文件上傳:按日期自動創建目錄、類型大小驗證、移動存儲與業務入庫完整流程

完整上傳處理流程

  1. 會話驗證(可選)
  2. 2. 配置允許類型、大小限制 3. 按日期創建存儲目錄(避免單目錄文件過多) 4. 檢查上傳文件有效性(is_uploaded_file) 5. 文件大小、MIME 類型雙重驗證 6. 生成唯一文件名(防覆蓋、防注入) 7. move_uploaded_file 安全移動 8. 可選:生成縮略圖、水印、掃毒 9. 入庫記錄(文件路徑、元數據、業務關聯) 10. 返回結果(JSON/重定向)

核心代碼實現

<?php
session_start();

// === 1. 業務會話驗證 ===
if (empty($_SESSION['Company'])) {
    // exit('未登錄'); // 視業務決定
}

// === 2. 上傳配置 ===
$allowedMimes = [
    'image/jpeg', 'image/png', 'image/gif', 'image/webp',
    'application/pdf', 'application/msword',
    'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
];
$maxFileSize = 10 * 1024 * 1024; // 10MB
$uploadBase = __DIR__ . '/uploads';

// === 3. 按日期創建目錄 ===
$dateDir = date('Ymd');
$targetDir = $uploadBase . DIRECTORY_SEPARATOR . $dateDir;
if (!is_dir($targetDir)) {
    if (!mkdir($targetDir, 0755, true)) {
        die(json_encode(['code' => 500, 'msg' => '目錄創建失敗']));
    }
}

// === 4. 請求方法檢查 ===
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    die(json_encode(['code' => 405, 'msg' => '僅支援 POST']));
}

// === 5. 文件存在性檢查 ===
if (!isset($_FILES['Pic']) || !is_uploaded_file($_FILES['Pic']['tmp_name'])) {
    die(json_encode(['code' => 400, 'msg' => '無有效上傳文件']));
}

$file = $_FILES['Pic'];

// === 6. 大小驗證 ===
if ($file['size'] > $maxFileSize) {
    die(json_encode(['code' => 413, 'msg' => '文件過大,限制 10MB']));
}

// === 7. 類型驗證(MIME + 擴展名雙重)===
if (!in_array($file['type'], $allowedMimes, true)) {
    // 進一步用 finfo 驗證真實 MIME
    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    $realMime = finfo_file($finfo, $file['tmp_name']);
    if (!in_array($realMime, $allowedMimes, true)) {
        die(json_encode(['code' => 415, 'msg' => '文件類型不允許']));
    }
}

// === 8. 生成唯一文件名 ===
$ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
$filename = bin2hex(random_bytes(16)) . '.' . $ext; // 32位隨機字符.擴展名
$destPath = $targetDir . DIRECTORY_SEPARATOR . $filename;

// 防衝突(極低概率)
if (file_exists($destPath)) {
    die(json_encode(['code' => 409, 'msg' => '文件衝突,請重試']));
}

// === 9. 安全移動 ===
if (!move_uploaded_file($file['tmp_name'], $destPath)) {
    die(json_encode(['code' => 500, 'msg' => '文件保存失敗']));
}

// === 10. 可選:圖片處理(縮略圖/水印)===
$imageInfo = getimagesize($destPath);
if ($imageInfo && in_array($imageInfo['mime'], ['image/jpeg','image/png','image/gif'])) {
    // 這裡可調用 Imagine/Intervention Image 生成縮略圖
    // generateThumbnail($destPath, $targetDir . '/thumb_' . $filename, 300, 300);
}

// === 11. 業務入庫 ===
require_once __DIR__ . '/Module/Factory.php';
try {
    $factory = new Factory();
    $tradeBLL = $factory->FactoryTrade();
    
    $infor = new Infor();
    $infor->Title = $_POST['Title'] ?? '';
    $infor->Deposit = $_POST['Deposit'] ?? 0;
    $infor->Hire = $_POST['Hire'] ?? 0;
    $infor->Location = $_POST['Location'] ?? '';
    $infor->Pic = $dateDir . '/' . $filename; // 存相對路徑
    $infor->Intro = $_POST['Intro'] ?? '';
    $infor->Member->ID = $_SESSION['MemberId'] ?? 0;
    $infor->Goods->BarCode = $_POST['GoodsBarCode'] ?? 0;
    $infor->Class->ID = 0; // 待擴展
    $infor->IssueTime = time();
    $infor->ViewNum = 0;
    $infor->State = 1;
    $infor->Top = 0;
    $infor->Recommend = 0;
    $infor->BookMember->ID = 0;
    $infor->BookTime = 0;
    $infor->BookRemark = '';
    
    $tradeBLL->CreateInfor($infor);
    
    echo json_encode(['code' => 200, 'msg' => '發布成功', 'path' => $infor->Pic]);
} catch (Exception $e) {
    // 入庫失敗可選:刪除已上傳文件
    // @unlink($destPath);
    echo json_encode(['code' => 500, 'msg' => $e->getMessage()]);
}
?>

關鍵安全與健壯性要點

1. 雙重 MIME 驗證

$_FILES['type'] 來自瀏覽器,不可信。**必須**用 finfo_file() 讀取文件魔數驗證真實類型。

2. 隨機文件名

bin2hex(random_bytes(16)) 生成 32 位十六進制字符串,極低衝突率,避免原始文件名帶來的注入、編碼、覆蓋風險。

3. 目錄結構設計

/uploads/
  20241219/
    a1b2c3d4e5f6...jpg
    thumb_a1b2c3d4e5f6...jpg
  20241220/
    ...
  • 單目錄文件數控制在萬級以下,避免 ls/readdir 性能下降、inode 耗盡。
  • 便於按天備份、清理、遷移。

4. 路徑存儲策略

數據庫存**相對路徑**(20241219/abc.jpg),而非絕對路徑。遷移存儲(本地→NAS→OSS)時只需修改基礎路徑常量,數據無需變更。

5. 錯誤處理統一化

統一返回 JSON:{code, msg, data},前端統一處理。避免直接 echo HTML/JS 混雜輸出。

6. 事務一致性

文件移動成功但入庫失敗時,應刪除文件或記錄「孤兒文件」定期清理。理想情況下將文件元數據入庫放在事務中(若用資料庫存二進制則原子性天然滿足)。

進階擴展:分片上傳與斷點續傳

大文件(>100MB)建議前端分片(如 Uppy、Plupload、WebUploader),後端:

  • 接收分片 → 臨時目錄存儲
  • 所有分片到齊 → 合併 → 驗證完整性(MD5/SHA256)
  • 移動至正式目錄 → 入庫
  • 支援斷點續傳:前端記錄已上傳分片索引,續傳時跳過

總結

文件上傳看似簡單,實則涉及**安全驗證、存儲架構、業務耦合、錯誤處理、擴展性**多個維度。本文提供的代碼模板涵蓋生產環境核心要素:日期分目錄、隨機命名、雙重 MIME 驗證、安全移動、相對路徑存儲、統一 JSON 響應、異常捕獲。在此基礎上可平滑擴展圖片處理、病毒掃描、對象存儲直傳、分片上傳等高級能力。

copyright © 萬盛學電腦網 all rights reserved