CodeIgniter上传含括号文件名的文件失败，提示文件类型不允许

嘿，这个问题我之前在项目里碰到过！本质是CodeIgniter的上传类对文件名的安全限制和扩展名解析逻辑，跟带括号的文件名起了冲突。下面给你几个靠谱的解决办法：

1. 允许文件名包含括号字符 #

CodeIgniter默认的上传配置里，allowed_filename_chars只放行字母、数字、下划线、破折号和点号，括号不在白名单里，这会直接导致上传被拦截。你只需要在配置里添加括号：

$config['upload_path'] = './images/project_docs/';
$config['allowed_types'] = 'gif|jpg|png|jpeg|pdf|pptx|docx|xlsx';
$config['max_size'] = '2000000';
$config['remove_spaces'] = true;
// 新增：允许括号和必要的字符
$config['allowed_filename_chars'] = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-().';

$this->load->library('upload', $config);
$this->upload->initialize($config);

2. 手动处理文件名避免解析错误 #

有时候即使放开了字符限制，上传类在解析sample(1).jpg这类文件名时，可能会误把(1).jpg当成扩展名，导致类型校验失败。这种情况下可以提前把括号替换成下划线（或者其他安全字符）：

// 假设你的上传表单字段名是'project_doc'
$original_name = $_FILES['project_doc']['name'];
// 把括号替换成下划线，保留扩展名
$safe_name = str_replace(['(', ')'], '_', $original_name);
$_FILES['project_doc']['name'] = $safe_name;

// 再执行上传流程
if (!$this->upload->do_upload('project_doc')) {
    // 处理错误提示
    echo $this->upload->display_errors();
} else {
    // 上传成功后的逻辑
    $upload_data = $this->upload->data();
}

3. 确认MIME类型配置（兜底方案） #

如果上面两步都没解决，可能是MIME类型识别出了问题。你可以打开application/config/mimes.php，检查对应扩展名的MIME类型是否完整，比如jpg对应的数组里是否包含image/jpeg、image/pjpeg等常见类型，避免因为MIME匹配失败被拦截。

为什么会出现这个问题？ #

CodeIgniter的上传类默认做了严格的安全校验：一是限制文件名只能包含安全字符，防止恶意文件名；二是通过文件名解析扩展名，再匹配MIME类型。带括号的文件名既不在默认安全字符列表里，还可能干扰扩展名的解析逻辑，所以才会弹出“文件类型不被允许”的错误。

内容的提问来源于stack exchange，提问作者Muhammad Taha