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()]);
}
?>
$_FILES['type'] 來自瀏覽器,不可信。**必須**用 finfo_file() 讀取文件魔數驗證真實類型。
bin2hex(random_bytes(16)) 生成 32 位十六進制字符串,極低衝突率,避免原始文件名帶來的注入、編碼、覆蓋風險。
/uploads/
20241219/
a1b2c3d4e5f6...jpg
thumb_a1b2c3d4e5f6...jpg
20241220/
...
ls/readdir 性能下降、inode 耗盡。數據庫存**相對路徑**(20241219/abc.jpg),而非絕對路徑。遷移存儲(本地→NAS→OSS)時只需修改基礎路徑常量,數據無需變更。
統一返回 JSON:{code, msg, data},前端統一處理。避免直接 echo HTML/JS 混雜輸出。
文件移動成功但入庫失敗時,應刪除文件或記錄「孤兒文件」定期清理。理想情況下將文件元數據入庫放在事務中(若用資料庫存二進制則原子性天然滿足)。
大文件(>100MB)建議前端分片(如 Uppy、Plupload、WebUploader),後端:
文件上傳看似簡單,實則涉及**安全驗證、存儲架構、業務耦合、錯誤處理、擴展性**多個維度。本文提供的代碼模板涵蓋生產環境核心要素:日期分目錄、隨機命名、雙重 MIME 驗證、安全移動、相對路徑存儲、統一 JSON 響應、異常捕獲。在此基礎上可平滑擴展圖片處理、病毒掃描、對象存儲直傳、分片上傳等高級能力。