CodeIgniter通过内置Upload类简化文件上传,需加载库并配置路径、类型、大小等参数;2. 设置upload_path、allowed_types、max_size及encrypt_name,确保目录可写;3. 使用do_upload()方法处理上传,配合form_open_multipart生成表单;4. 注意PHP的file_uploads、post_max_size等配置,验证文件真实性以提升安全性。

在CodeIgniter中实现文件上传功能非常方便,框架自带了Upload类,可以快速处理图片、文档等文件的上传。下面介绍如何配置和使用该功能,包括核心代码示例和关键配置要点。
加载上传类并设置基本配置
在控制器中,首先需要加载CodeIgniter的上传库,并设置上传路径、允许类型、大小限制等参数。
$this->load->library('upload');
$config['upload_path'] = './uploads/';
$config['allowed_types'] = 'gif|jpg|png|jpeg|pdf|docx';
$config['max_size'] = 2048; // 单位KB,即2MB
$config['encrypt_name'] = TRUE; // 加密文件名防止冲突
$this->upload->initialize($config);
注意:
- upload_path 必须是服务器上的绝对路径或相对于根目录的相对路径,且目录需有写权限(chmod 755 或 777)
- allowed_types 设置允许的文件扩展名,用竖线分隔
- encrypt_name 可避免重名覆盖
执行文件上传并处理结果
使用 do_upload() 方法执行上传,传入表单中文件字段的名称(如 input name="userfile")。
if (!$this->upload->do_upload('userfile')) {
$error = array('error' => $this->upload->display_errors());
$this->load->view('upload_form', $error);
} else {
$data = array('upload_data' => $this->upload->data());
$this->load->view('upload_success', $data);
}
$this->upload->data() 返回上传文件的详细信息,包括:
- file_name:保存后的文件名
- file_type:MIME类型
- file_size:文件大小(KB)
- full_path:完整保存路径
视图中的文件上传表单
确保HTML表单使用 multipart/form-data 编码类型,并指定正确的input类型。
如果未使用CI的form辅助函数,原生写法为:
常见问题与注意事项
实际开发中容易忽略以下几点:
- 确保 ./uploads/ 目录存在且可写(Linux下一般需 chmod 777 uploads)
- PHP配置中 file_uploads = On,且 post_max_size 和 upload_max_filesize 要足够大
- 上传字段名必须与 do_upload() 参数一致,默认为 'userfile',也可自定义
- 多文件上传需循环调用 do_upload(),每次处理一个文件
- 安全建议:对图片文件可结合图像处理库验证是否真实图像
基本上就这些,不复杂但容易忽略细节。只要配置好路径权限和PHP设置,CodeIgniter的文件上传功能稳定又高效。









