上傳流程核心步驟
- HTML 表單設置
enctype="multipart/form-data"、method="POST"、input type="file"。
- PHP 通過
$_FILES['field_name'] 超全局數組獲取文件元數據。
- 服務端驗證:錯誤碼、文件類型、大小、MIME 欺騙、文件名安全。
- 移動臨時文件至目標目錄:
move_uploaded_file()。
- 業務邏輯處理:重命名、入庫、生成縮略圖、病毒掃描等。
關鍵變量 $_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>
進階安全加固清單
- 禁用腳本執行權限: 上傳目錄配置 Nginx/Apache 禁止 PHP/腳本執行。
# Nginx
location /uploads/ {
location ~ \.php$ { deny all; return 403; }
}
# Apache .htaccess
<FilesMatch "\.php$">
Require all denied
</FilesMatch>
- 文件名去標識化: 不使用原始文件名,防止路徑遍歷(
../../etc/passwd)、特殊字符注入、中文編碼問題。
- 內容檢測:
finfo 檢測真實 MIME;圖片用 getimagesize() 驗證真實尺寸;視頻/文檔可接入 ClamAV 病毒掃描。
- 限制並發與總量: Redis 計數器限制用戶每分鐘上傳次數、每日總大小。
- 分離存儲: 生產環境使用對象存儲(OSS/S3/MinIO),Web 服務器無寫入權限,通過預簽名 URL 直傳。
- 圖片二次渲染: GD/Imagick 讀取並重新保存,剝離潛在的圖片馬(polyglot)。
大文件分片上傳(斷點續傳)架構
- 前端:SparkMD5 計算文件 Hash,按 5MB 分片。
- 上傳前請求
/api/upload/check?hash=xxx 秒傳/斷點檢查。
- 逐片上傳
/api/upload/chunk,參數:hash, index, chunk。
- 服務端:臨時目錄保存分片,合併驗證 Hash 後移至正式目錄。
- 推薦成熟庫:
plupload、uppy、webuploader(前端);PHP 端參考 league/flysystem 存儲抽象。