表單設定三要素
method="post" - 檔案上傳必須使用 POST
enctype="multipart/form-data" - 多部分表單編碼
<input type="hidden" name="MAX_FILE_SIZE" value="100000"> - 客戶端建議限制 (非強制)
$_FILES 陣列結構
$_FILES['field_name'] = [
'name' => 'photo.jpg', // 原始檔名
'type' => 'image/jpeg', // 瀏覽器回報 MIME (不可信)
'tmp_name' => '/tmp/phpA1b2C3', // 伺服器暫存路徑
'error' => 0, // 錯誤代碼 (0=成功)
'size' => 102400 // 檔案大小 (位元組)
];
常見 MIME 類型對照表
| 分類 | MIME Type | 副檔名 |
| 文字 | text/html | .html, .htm |
| text/plain | .txt, .log |
| 圖片 | image/gif | .gif |
| image/jpeg | .jpeg, .jpg |
| image/png | .png |
| 音訊 | audio/midi | .mid, .midi |
| audio/wav | .wav |
| 影片 | video/quicktime | .qt, .mov |
| video/mpeg | .mpeg |
| 應用程式 | application/pdf | .pdf |
| application/msword | .doc, .dot |
| application/vnd.ms-excel | .xls |
| application/vnd.ms-powerpoint | .ppt |
| application/zip | .zip |
| application/rar | .rar |
| application/xml | .xml, .xsl |
| application/octet-stream | .bin, .exe, .dll, .class |
核心處理函數
is_uploaded_file($tmp_name):確認是 HTTP POST 上傳的檔案 (防偽造)
move_uploaded_file($tmp_name, $destination):移動暫存檔到永久位置 (自動檢查是否為上傳檔案)
基本上傳流程
<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
$file = $_FILES['myfile'] ?? null;
if (!$file || $file['error'] !== UPLOAD_ERR_OK) {
$errors = [
UPLOAD_ERR_INI_SIZE => '超過伺服器限制',
UPLOAD_ERR_FORM_SIZE => '超過表單限制',
UPLOAD_ERR_PARTIAL => '上傳不完整',
UPLOAD_ERR_NO_FILE => '未選擇檔案',
];
die($errors[$file['error']] ?? '上傳失敗');
}
// 簡單驗證:副檔名
$allowedExt = ['jpg', 'jpeg', 'png', 'gif'];
$ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
if (!in_array($ext, $allowedExt)) {
die('不支援的檔案格式');
}
// 移動到上傳目錄
$uploadDir = __DIR__ . '/uploads/';
if (!is_dir($uploadDir)) mkdir($uploadDir, 0755, true);
$newName = uniqid('img_') . '.' . $ext;
$dest = $uploadDir . $newName;
if (move_uploaded_file($file['tmp_name'], $dest)) {
echo "上傳成功!檔案:$dest";
} else {
echo "移動檔案失敗";
}
}
?>
進階安全建議
- 使用
finfo 檢測真實 MIME 型別,不信任 $_FILES['type']
- 檔名重新命名,避免中文、特殊字元、路徑遍歷
- 上傳目錄設定**不可執行** (Nginx/Apache 禁止 PHP 執行)
- 病毒掃描整合 (ClamAV 等)
- 限制同時上傳數量與總大小