PHP 多檔案上傳陣列重組：將 $_FILES 多維結構轉為單檔案陣列

PHP 多檔案上傳陣列重組：將 $_FILES 多維結構轉為單檔案陣列

PHP 多檔案上傳時 $_FILES 呈現「欄位優先」的多維結構，處理起來不直觀。本文提供一個實用的重組函數，將其轉換為「檔案優先」的單層陣列，方便迴圈處理每個上傳檔案。

原始 $_FILES 結構

// 表單： x3
$_FILES['UpLoadFile'] = array(
    'name'     => array('a.jpg', 'b.png', 'c.gif'),
    'type'     => array('image/jpeg', 'image/png', 'image/gif'),
    'tmp_name' => array('/tmp/php1', '/tmp/php2', '/tmp/php3'),
    'error'    => array(0, 0, 0),
    'size'     => array(1234, 5678, 9012),
);

目標重組結構

$files = array(
    0 => array('name'=>'a.jpg', 'type'=>'image/jpeg', 'tmp_name'=>'/tmp/php1', 'error'=>0, 'size'=>1234),
    1 => array('name'=>'b.png', 'type'=>'image/png', 'tmp_name'=>'/tmp/php2', 'error'=>0, 'size'=>5678),
    2 => array('name'=>'c.gif', 'type'=>'image/gif', 'tmp_name'=>'/tmp/php3', 'error'=>0, 'size'=>9012),
);

重組函數實作

<?php
function reorganizeFilesArray($files) {
    $result = array();
    $keys = array_keys($files); // name, type, tmp_name, error, size
    $count = count($files[$keys[0]]);
    
    for ($i = 0; $i < $count; $i++) {
        $file = array();
        foreach ($keys as $key) {
            $file[$key] = $files[$key][$i];
        }
        $result[] = $file;
    }
    return $result;
}

// 使用範例
if (!empty($_FILES['UpLoadFile'])) {
    $uploadFiles = reorganizeFilesArray($_FILES['UpLoadFile']);
    
    foreach ($uploadFiles as $file) {
        if ($file['error'] === UPLOAD_ERR_OK) {
            move_uploaded_file($file['tmp_name'], 'uploads/' . $file['name']);
            echo "上傳成功: {$file['name']}<br>";
        } else {
            echo "上傳失敗: {$file['name']} (錯誤碼: {$file['error']})<br>";
        }
    }
}
?>

完整測試頁面

<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>多檔上傳測試</title></head><body>
<form action="" method="post" enctype="multipart/form-data">
    <input name="UpLoadFile[]" type="file" /><br>
    <input name="UpLoadFile[]" type="file" /><br>
    <input name="UpLoadFile[]" type="file" /><br>
    <input type="submit" value="上傳" />
</form>

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    echo '<h3>原始 $_FILES 結構</h3>';
    echo '<pre>'; print_r($_FILES['UpLoadFile']); echo '</pre>';
    
    $files = reorganizeFilesArray($_FILES['UpLoadFile']);
    echo '<h3>重組後結構</h3>';
    echo '<pre>'; print_r($files); echo '</pre>';
}
?>
</body></html>

進階版：支援多組檔案欄位

<?php
function reorganizeAllFiles() {
    $all = array();
    foreach ($_FILES as $fieldName => $files) {
        if (is_array($files['name'])) {
            $all[$fieldName] = reorganizeFilesArray($files);
        } else {
            // 單檔案欄位轉為統一格式
            $all[$fieldName] = array($files);
        }
    }
    return $all;
}

// 使用
$allFiles = reorganizeAllFiles();
foreach ($allFiles as $fieldName => $files) {
    echo "欄位: $fieldName<br>";
    foreach ($files as $file) {
        // 統一處理邏輯
    }
}
?>

常見錯誤碼對照

最佳實踐建議

1. 永遠檢查 $file['error'] === UPLOAD_ERR_OK 再處理
2. 使用 move_uploaded_file() 而非 copy() 確保安全
3. 檔名重組：uniqid() . '_' . basename($file['name']) 避免衝突
4. 型別驗證：結合 finfo_file() 檢測真實 MIME 型別
5. 大小限制：同時設定 php.ini、表單隱藏欄位、程式碼三層防護

將 $_FILES 重組為檔案優先結構，能大幅簡化多檔案上傳的處理邏輯，減少索引錯誤。建議將重組函數封裝至共用工具庫，專案中統一呼叫。