最基礎的 PHP 檔案上傳處理流程:表單建構、上傳驗證、移動檔案、錯誤處理。適合快速原型與學習參考。
<form action="upload.php" method="post" enctype="multipart/form-data">
<input type="file" name="ufile" required>
<button type="submit">上傳</button>
</form>
關鍵點:
method="post" — 檔案必須用 POSTenctype="multipart/form-data" — 瀏覽器才會正確編碼檔案內容name="ufile" — 對應 $_FILES['ufile']upload.php<?php
// 設定上傳目錄(需可寫入權限)
define('UPLOAD_DIR', __DIR__ . '/uploads/');
if (!is_dir(UPLOAD_DIR)) {
mkdir(UPLOAD_DIR, 0755, true);
}
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
// 1. 檢查是否有檔案上傳
if (empty($_FILES['ufile']) || $_FILES['ufile']['error'] !== UPLOAD_ERR_OK) {
$error_code = $_FILES['ufile']['error'] ?? UPLOAD_ERR_NO_FILE;
$messages = [
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 => '檔案寫入失敗',
UPLOAD_ERR_EXTENSION => '被 PHP 延伸模組阻擋',
];
die('上傳失敗:' . ($messages[$error_code] ?? "未知錯誤 ($error_code)"));
}
$file = $_FILES['ufile'];
$tmp_name = $file['tmp_name'];
$orig_name = basename($file['name']);
// 2. 安全處理檔名:防止路徑遍歷、覆蓋、特殊字元
$ext = strtolower(pathinfo($orig_name, PATHINFO_EXTENSION));
$allowed_ext = ['jpg', 'jpeg', 'png', 'gif', 'pdf', 'txt', 'doc', 'docx'];
if (!in_array($ext, $allowed_ext, true)) {
die('不允許的檔案類型:' . htmlspecialchars($ext));
}
// 產生唯一檔名:時間戳 + 隨機字串 + 原始副檔名
$new_name = date('Ymd_His') . '_' . bin2hex(random_bytes(8)) . '.' . $ext;
$dest_path = UPLOAD_DIR . $new_name;
// 3. 驗證是否真為上傳檔案(防偽造)
if (!is_uploaded_file($tmp_name)) {
die('非法上傳嘗試');
}
// 4. 移動檔案
if (!move_uploaded_file($tmp_name, $dest_path)) {
die('檔案移動失敗,請檢查目錄權限');
}
// 5. 成功回應
echo "上傳成功!
";
echo "原始檔名:", htmlspecialchars($orig_name), "
";
echo "儲存路徑:", htmlspecialchars($dest_path), "
";
echo "檔案大小:", number_format($file['size'] / 1024, 2), " KB
";
echo '<a href="uploads/' . urlencode($new_name) . '" target="_blank">檢視檔案</a>';
// 記錄日誌(可選)
error_log(sprintf('UPLOAD: %s -> %s (%.2f KB)', $orig_name, $new_name, $file['size']/1024));
}
?>
| 檢查項目 | 目的 | 實作方式 |
|---|---|---|
| 錯誤代碼檢查 | 攔截上傳失敗 | $_FILES['ufile']['error'] === UPLOAD_ERR_OK |
| 副檔名白名單 | 防惡意腳本上傳 | in_array($ext, $allowed, true) |
| MIME 型態驗證 | 雙重保險 | finfo_file(finfo_open(FILEINFO_MIME_TYPE), $tmp_name) |
| 檔案大小限制 | 防止佔滿磁碟 | $file['size'] <= 5 * 1024 * 1024 (5MB) |
| 檔名安全化 | 防路徑遍歷、覆蓋 | 重新命名、basename()、移除特殊字元 |
| is_uploaded_file() | 確認檔案確實經由 HTTP POST 上傳 | 防止本地檔案讀取攻擊 |
| 上傳目錄權限 | 最小權限原則 | chmod 755、不可執行、設 open_basedir |
| Web 可存取隔離 | 防直接執行上傳的 PHP 腳本 | 上傳目錄設 php_flag engine off 或放在 Webroot 外 |
<input type="file" name="ufiles[]" multiple>
<?php
foreach ($_FILES['ufiles']['tmp_name'] as $idx => $tmp_name) {
if ($_FILES['ufiles']['error'][$idx] !== UPLOAD_ERR_OK) continue;
$orig_name = $_FILES['ufiles']['name'][$idx];
// ... 單檔處理邏輯 ...
}
簡易版不支援大檔案(受限 post_max_size、upload_max_filesize、記憶體、執行時間)。生產環境大檔案建議:
File.prototype.slice() + spark-md5 計算雜湊掌握基礎上傳流程後,請務必依照安全檢查點強化,再部署至生產環境。