CodeIgniter多站点上传故障：子站_admin无法上传至主站assets目录

我碰到过好几次这种跨目录上传的场景，核心其实是路径定位错误和文件系统权限不足这两个关键点没处理对，结合你的部署结构，给你一步步排查和解决的方案：

1. 先确认上传目标路径的正确性 #

你的子站（Quartiere/_admin）是CodeIgniter项目，CI默认的FCPATH常量指向的是子站的根目录（也就是_admin文件夹）。要上传到主目录的assets，你需要用相对路径跳出子站目录：

在你的上传配置里，把upload_path改成：

$config['upload_path'] = FCPATH . '../assets/';

👉 调试小技巧：可以先打印这个路径确认是否正确：

echo $config['upload_path']; 
exit;

输出应该是类似/var/www/html/Quartiere/assets/这样的绝对路径，确保这个目录确实存在。

2. 检查目标目录的文件系统权限 #

这是最容易被忽略的点：Web服务器的运行用户（比如www-data、apache、nginx）需要对Quartiere/assets目录有写入权限。

本地开发环境（临时测试）： #

chmod -R 777 /path/to/Quartiere/assets

⚠️ 注意：生产环境绝对不要用777权限，太不安全！

生产环境（正确做法）： #

先设置目录的所有者为Web服务器用户：

sudo chown -R www-data:www-data /path/to/Quartiere/assets

再设置合理的权限：

sudo chmod -R 755 /path/to/Quartiere/assets

3. 排查CodeIgniter的安全与表单配置 #

• 确保表单是多部分表单：上传文件必须用form_open_multipart，而不是普通的form_open：

  <?php echo form_open_multipart('你的控制器/上传方法'); ?>
  

• CSRF保护检查：如果你的CI开启了CSRF保护（config.php里$config['csrf_protection'] = TRUE;），表单里必须包含CSRF token。可以用CI的内置方法自动生成：

  echo form_hidden($this->security->get_csrf_token_name(), $this->security->get_csrf_hash());
  

  或者form_open_multipart会自动帮你添加这个字段，只要你没手动禁用。

4. 完善上传配置的细节 #

检查你的上传配置是否有遗漏：

$config['allowed_types'] = 'jpg|png|gif|pdf'; // 根据你的需求设置允许的文件类型
$config['max_size'] = 2048; // 单位KB，根据需求调整
$config['overwrite'] = FALSE; // 不覆盖同名文件，或者设为TRUE允许覆盖
$config['encrypt_name'] = TRUE; // 自动生成随机文件名，避免重名和安全问题

5. 开启调试捕获具体错误 #

如果还是失败，直接看CI的错误提示：
在控制器的上传方法里，捕获上传错误并打印：

if (!$this->upload->do_upload('userfile')) {
    // 打印详细错误信息
    echo $this->upload->display_errors();
    exit;
} else {
    // 上传成功后的逻辑
    $upload_data = $this->upload->data();
}

另外可以开启CI的日志功能，在config.php里设置：

$config['log_threshold'] = 2;

然后去_admin/application/logs目录下查看日志，里面会有更详细的错误原因（比如路径不存在、权限不足、文件大小超标等）。

内容的提问来源于stack exchange，提问作者Mitca Vicentiu