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');
<p>$config['upload_path'] = './uploads/';
$config['allowed_types'] = 'gif|jpg|png|jpeg|pdf|docx';
$config['max_size'] = 2048; // 单位KB，即2MB
$config['encrypt_name'] = TRUE; // 加密文件名防止冲突</p><p>$this->upload->initialize($config);</p>注意：
- 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类型。
<?php echo form_open_multipart('upload/do_upload');?>
<input type="file" name="userfile" size="20" />
<input type="submit" value="上传" />
</form>如果未使用CI的form辅助函数，原生写法为：
<form method="post" action="/upload/do_upload" enctype="multipart/form-data">
常见问题与注意事项
实际开发中容易忽略以下几点：
- 确保 ./uploads/ 目录存在且可写（Linux下一般需 chmod 777 uploads）
- PHP配置中 file_uploads = On，且 post_max_size 和 upload_max_filesize 要足够大
- 上传字段名必须与 do_upload() 参数一致，默认为 'userfile'，也可自定义
- 多文件上传需循环调用 do_upload()，每次处理一个文件
- 安全建议：对图片文件可结合图像处理库验证是否真实图像
基本上就这些，不复杂但容易忽略细节。只要配置好路径权限和PHP设置，CodeIgniter的文件上传功能稳定又高效。
