檔案上傳是 Web 開發常見功能,但也是安全風險高發區。本文從基礎 move_uploaded_file() 用法切入,完整示範上傳表單、後端處理、檔案驗證、隨機命名、錯誤處理與安全防護要點。
bool move_uploaded_file(string $filename, string $destination)
/*
參數:
$filename - $_FILES['file']['tmp_name'] 暫存檔路徑
$destination - 目標儲存完整路徑(含檔名)
回傳:成功 true、失敗 false
注意:僅限 HTTP POST 上傳檔案,目標檔案存在會被覆蓋
*/
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>PHP 檔案上傳範例</title>
</head>
<body>
<form action="upload.php" method="post" enctype="multipart/form-data">
<input type="hidden" name="MAX_FILE_SIZE" value="2000000"> <!-- 限制 2MB -->
<input type="file" name="userfile" accept="image/*,.pdf,.txt">
<input type="submit" value="上傳檔案">
</form>
</body>
</html>
<?php
// 設定上傳目錄(需可寫入權限)
$uploadDir = __DIR__ . '/uploads/';
if (!is_dir($uploadDir)) {
mkdir($uploadDir, 0755, true);
}
// 檢查是否為 POST 請求且有檔案上傳
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['userfile'])) {
$file = $_FILES['userfile'];
// 1. 基礎錯誤檢查
if ($file['error'] !== UPLOAD_ERR_OK) {
$errors = [
UPLOAD_ERR_INI_SIZE => '檔案超過 php.ini upload_max_filesize',
UPLOAD_ERR_FORM_SIZE => '檔案超過表單 MAX_FILE_SIZE',
UPLOAD_ERR_PARTIAL => '檔案僅部分上傳',
UPLOAD_ERR_NO_FILE => '未選擇檔案',
UPLOAD_ERR_NO_TMP_DIR => '缺少暫存目錄',
UPLOAD_ERR_CANT_WRITE => '寫入磁碟失敗',
];
die('上傳錯誤: ' . ($errors[$file['error']] ?? '未知錯誤'));
}
// 2. 檔案類型驗證(建議同時驗證 MIME 與副檔名)
$allowedMimes = ['image/jpeg', 'image/png', 'image/gif', 'application/pdf', 'text/plain'];
$finfo = finfo_open(FILEINFO_MIME_TYPE);
$mime = finfo_file($finfo, $file['tmp_name']);
finfo_close($finfo);
if (!in_array($mime, $allowedMimes, true)) {
die('不允許的檔案類型: ' . $mime);
}
// 3. 產生安全檔名:隨機字串 + 原始副檔名
$ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
$newName = bin2hex(random_bytes(16)) . '.' . $ext;
$destPath = $uploadDir . $newName;
// 4. 移動檔案
if (move_uploaded_file($file['tmp_name'], $destPath)) {
echo "上傳成功!檔案儲存為: {$newName}";
// 可在此寫入資料庫記錄:原始檔名、儲存檔名、MIME、大小、上傳時間等
} else {
echo '上傳失敗:無法移動檔案';
}
} else {
echo '請透過表單上傳檔案';
}
?>
finfo_file() 而非依賴 $_FILES['type'](可偽造)upload_max_filesize、post_max_size、表單 MAX_FILE_SIZE 三層防護| 現象 | 可能原因 | 解決方向 |
|---|---|---|
| $_FILES 為空 | 表單缺少 enctype、檔案過大、php.ini 關閉上傳 | 檢查表單屬性、調整 php.ini 設定 |
| move_uploaded_file 回傳 false | 目錄權限不足、磁碟空間不足、open_basedir 限制 | 確認目錄可寫、檢查錯誤日誌 |
| 上傳大檔案失敗 | 超過 post_max_size、max_execution_time、memory_limit | 調整 php.ini、考慮分片上傳 |
<input type="file" name="files[]" multiple> 配合迴圈處理