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),必須全覆蓋。
在控制器中動態合併:
<?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();
// 入庫、解壓、掃毒等後續處理
}
}
allowed_types 限制後綴,第一道關卡。mimes.php + finfo 真實檢測,第二道關卡。clamdscan 或云端病毒掃描 API。../)、腳本文件。php_flag engine off(Apache)或 Nginx location ~ \.php$ { deny all; },禁止腳本執行。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 檢測、病毒掃描、存儲隔離、隨機命名,構建完整上傳安全鏈路。