萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP $_FILES 上傳檔案資訊陣列完整參考手冊

$_FILES 結構總覽

當表單使用 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

多檔上傳結構(name="files[]")

<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_OK0成功正常處理
UPLOAD_ERR_INI_SIZE1超過 php.ini upload_max_filesize調整 php.ini 或壓縮檔案
UPLOAD_ERR_FORM_SIZE2超過表單 MAX_FILE_SIZE檢查隱藏欄位值
UPLOAD_ERR_PARTIAL3上傳中斷檢查網路、重試
UPLOAD_ERR_NO_FILE4未選檔案前端驗證 required
UPLOAD_ERR_NO_TMP_DIR6缺暫存目錄檢查 php.ini upload_tmp_dir
UPLOAD_ERR_CANT_WRITE7寫入失敗檢查磁碟空間/權限
UPLOAD_ERR_EXTENSION8擴充功能阻擋檢查 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'];
}
?>

php.ini 關鍵設定

指令預設建議說明
file_uploadsOnOn啟用上傳功能
upload_max_filesize2M10M單檔上限
post_max_size8M12MPOST 總量上限,必須 > upload_max_filesize
max_file_uploads2020單次最多檔案數
upload_tmp_dir系統預設自訂目錄暫存目錄,需寫入權限
max_input_time60300大檔上傳需較久時間
copyright © 萬盛學電腦網 all rights reserved