萬盛學電腦網

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

CodeIgniter 解決無法上傳 RAR/ZIP 壓縮包:MIME 類型配置詳解

問題根因

CodeIgniter 上傳類 Upload 依賴 application/config/mimes.php 定義的 MIME 白名單進行文件類型驗證。預設配置:

  • 缺少 rar 定義
  • zip 定義不全,導致合法壓縮包被拒絕

解決方案:擴展 mimes.php

編輯 application/config/mimes.php,在 $mimes 數組中添加/補全:

<?php
// application/config/mimes.php
$mimes = [
    // ... 現有配置保持不變 ...
    
    // ZIP:補全所有常見 MIME 類型
    'zip' => [
        'application/zip',
        'application/x-zip',
        'application/x-zip-compressed',
        'application/octet-stream',      // 通用二進制流,許多瀏覽器/客戶端發送此類型
        'multipart/x-zip',               // 少見但存在
    ],
    
    // RAR:完整添加
    'rar' => [
        'application/x-rar-compressed',
        'application/octet-stream',
        'application/vnd.rar',
    ],
    
    // 常見其他壓縮格式(建議同步補全)
    '7z'    => ['application/x-7z-compressed', 'application/octet-stream'],
    'gz'    => ['application/gzip', 'application/x-gzip'],
    'tar'   => ['application/x-tar'],
    'tgz'   => ['application/x-gtar', 'application/x-tar-gz'],
    'bz2'   => ['application/x-bzip2'],

驗證邏輯深度解析

CI Upload 庫驗證流程(簡化):


// 系統庫:system/libraries/Upload.php
public function _file_mime_type($file) {
    // 1. 獲取文件擴展名
    $ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
    
    // 2. 從 mimes.php 獲取該擴展名允許的 MIME 列表
    $mimes = $this->mimes[$ext] ?? [];
    
    // 3. 檢測文件真實 MIME(finfo/Fileinfo 擴展)
    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    $mime = finfo_file($finfo, $file['tmp_name']);
    
    // 4. 若真實 MIME 在允許列表中 → 通過
    return in_array($mime, $mimes, true);
}

因此,**mimes.php 必須包含該文件實際可能被檢測出的所有 MIME 類型**。不同瀏覽器/客戶端/伺服器對同一文件可能報告不同 MIME(如 ZIP 可能是 application/zip、application/x-zip-compressed、application/octet-stream),必須全覆蓋。

進階:動態擴展 MIME(不修改核心配置文件)

在控制器中動態合併:

<?php
// 控制器方法
public function upload_package() {
    $this->load->library('upload');
    
    // 動態追加 MIME(僅影響當前實例)
    $extraMimes = [
        'zip' => ['application/zip', 'application/x-zip-compressed', 'application/octet-stream'],
        'rar' => ['application/x-rar-compressed', 'application/octet-stream'],
    ];
    $this->upload->set_mimes(array_merge($this->upload->mimes, $extraMimes));
    
    $config = [
        'upload_path'   => './uploads/packages/',
        'allowed_types' => 'zip|rar|7z', // 擴展名白名單
        'max_size'      => 102400,       // 100MB
        'encrypt_name'  => true,         // 隨機加密文件名
    ];
    $this->upload->initialize($config);
    
    if (!$this->upload->do_upload('package')) {
        $error = $this->upload->display_errors();
        // 處理錯誤
    } else {
        $data = $this->upload->data();
        // 入庫、解壓、掃毒等後續處理
    }
}

安全加固:不僅靠 MIME 白名單

  1. 擴展名白名單:allowed_types 限制後綴,第一道關卡。
  2. MIME 白名單:mimes.php + finfo 真實檢測,第二道關卡。
  3. 文件內容掃描:上傳後調用 clamdscan 或云端病毒掃描 API。
  4. 解壓驗證:壓縮包需解壓檢查內部文件類型、大小、路徑遍歷(../)、腳本文件。
  5. 存儲隔離:上傳目錄設置 php_flag engine off(Apache)或 Nginx location ~ \.php$ { deny all; },禁止腳本執行。
  6. 隨機重命名:encrypt_name = true 或自定義 file_name 生成策略。

常見坑與排查

現象可能原因排查步驟
配置了仍提示「文件類型不允許」MIME 列表不全 / finfo 擴展未裝 / 緩存舊配置1. var_dump(finfo_file(...)) 看真實 MIME 2. 確認 mimes.php 已生效 3. 重啟 php-fpm
大文件上傳失敗post_max_size / upload_max_filesize / client_max_body_size 不足參考「大文件上傳配置」文章調整三層配置
上傳後無法下載/解壓文件損壞 / 存儲路徑權限 / 輸出時未設置正確 Header檢查文件完整性、下載腳本 Content-Type

總結

CodeIgniter 上傳壓縮包失敗 90% 因 mimes.php 定義不全。核心修復:**補全 zip/rar 所有可能的 MIME 類型(特別是 application/octet-stream)**。配合擴展名白名單、真實 MIME 檢測、病毒掃描、存儲隔離、隨機命名,構建完整上傳安全鏈路。

copyright © 萬盛學電腦網 all rights reserved