當表單使用 enctype="multipart/form-data" 且 <input type="file" name="fupload"> 上傳檔案後,$_FILES['fupload'] 會包含以下鍵值:
| 鍵名 | 說明 | 範例值 |
|---|---|---|
name | 用戶端原始檔名 | photo.jpg |
type | 瀏覽器回報的 MIME 型別(不可信) | image/jpeg |
tmp_name | 伺服器暫存檔完整路徑 | /tmp/phpA1b2C3 |
size | 檔案大小(位元組) | 2048576 |
error | 錯誤代碼(0=成功) | UPLOAD_ERR_OK |
<input type="file" name="files[]" multiple>
$_FILES['files'] 結構變為:
Array
(
[name] => Array ( [0] => a.jpg, [1] => b.png )
[type] => Array ( [0] => image/jpeg, [1] => image/png )
[tmp_name] => Array ( [0] => /tmp/phpX1, [1] => /tmp/phpY2 )
[size] => Array ( [0] => 1024, [1] => 2048 )
[error] => Array ( [0] => 0, [1] => 0 )
)
遍歷方式:
<?php
$files = $_FILES['files'];
$count = count($files['name']);
for ($i = 0; $i < $count; $i++) {
if ($files['error'][$i] === UPLOAD_ERR_OK) {
$name = $files['name'][$i];
$tmp = $files['tmp_name'][$i];
$size = $files['size'][$i];
// 處理單一檔案...
}
}
?>
| 常數 | 值 | 原因 | 處理建議 |
|---|---|---|---|
| UPLOAD_ERR_OK | 0 | 成功 | 正常處理 |
| UPLOAD_ERR_INI_SIZE | 1 | 超過 php.ini upload_max_filesize | 調整 php.ini 或壓縮檔案 |
| UPLOAD_ERR_FORM_SIZE | 2 | 超過表單 MAX_FILE_SIZE | 檢查隱藏欄位值 |
| UPLOAD_ERR_PARTIAL | 3 | 上傳中斷 | 檢查網路、重試 |
| UPLOAD_ERR_NO_FILE | 4 | 未選檔案 | 前端驗證 required |
| UPLOAD_ERR_NO_TMP_DIR | 6 | 缺暫存目錄 | 檢查 php.ini upload_tmp_dir |
| UPLOAD_ERR_CANT_WRITE | 7 | 寫入失敗 | 檢查磁碟空間/權限 |
| UPLOAD_ERR_EXTENSION | 8 | 擴充功能阻擋 | 檢查 suhosin 等擴充設定 |
<?php
function validateUpload($file, array $allowedMimes, int $maxSize = 2_000_000): array {
// 1. 檢查錯誤代碼
if ($file['error'] !== UPLOAD_ERR_OK) {
return ['ok' => false, 'msg' => '上傳錯誤代碼:' . $file['error']];
}
// 2. 檢查大小
if ($file['size'] > $maxSize) {
return ['ok' => false, 'msg' => '檔案過大(限制 ' . ($maxSize/1024/1024) . 'MB)'];
}
// 3. 檢查 MIME(使用 finfo,不信任 $_FILES['type'])
$finfo = finfo_open(FILEINFO_MIME_TYPE);
$mime = finfo_file($finfo, $file['tmp_name']);
finfo_close($finfo);
if (!in_array($mime, $allowedMimes, true)) {
return ['ok' => false, 'msg' => '不允許的檔案類型:' . $mime];
}
// 4. 檢查副檔名(雙重保險)
$ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
$allowedExt = ['jpg', 'jpeg', 'png', 'gif', 'pdf']; // 依 MIME 對應調整
if (!in_array($ext, $allowedExt, true)) {
return ['ok' => false, 'msg' => '副檔名不允許'];
}
return ['ok' => true, 'mime' => $mime, 'ext' => $ext];
}
// 使用
$result = validateUpload($_FILES['avatar'], ['image/jpeg', 'image/png']);
if ($result['ok']) {
move_uploaded_file($_FILES['avatar']['tmp_name'], $destination);
} else {
echo $result['msg'];
}
?>
| 指令 | 預設 | 建議 | 說明 |
|---|---|---|---|
| file_uploads | On | On | 啟用上傳功能 |
| upload_max_filesize | 2M | 10M | 單檔上限 |
| post_max_size | 8M | 12M | POST 總量上限,必須 > upload_max_filesize |
| max_file_uploads | 20 | 20 | 單次最多檔案數 |
| upload_tmp_dir | 系統預設 | 自訂目錄 | 暫存目錄,需寫入權限 |
| max_input_time | 60 | 300 | 大檔上傳需較久時間 |