CodeIgniter3中move_upload_file()无法将图片上传到指定目录如何解决

使用CodeIgniter 3框架开发时，调用原生move_uploaded_file()将上传图片存入指定profile_image目录功能失效，对应现有实现、目录结构及修复方案如下：

现有实现与目录结构 #

业务代码 #

$original_filename = $_FILES['file']['name'];
$file_tmp  = $_FILES['file']['tmp_name'];
move_uploaded_file($file_tmp, "profile_image/" . $original_filename);

目录结构 #

ProjectName
  └── profile_image

失效原因与修复方案 #

按优先级逐一排查以下问题即可：

• 相对路径解析错误：CI的相对路径以入口文件index.php所在目录为基准，而非当前业务代码文件所在目录，直接写相对路径很容易出现路径定位偏差。直接使用CI预定义常量FCPATH（指向入口文件所在的项目根目录的绝对路径）拼接目标路径即可，目标路径格式为FCPATH . "profile_image/" . 文件名。
• 目录无写入权限：给profile_image目录分配web运行用户（常见为www-data、nginx、apache）的写入权限，Linux环境可先执行chmod 755 profile_image测试，属主需与web服务运行用户一致，生产环境禁止长期设置777权限。
• 上传流程本身出错：先判断$_FILES['file']['error']是否等于常量UPLOAD_ERR_OK（值为0），非0值即代表上传阶段就失败了：值为1代表文件大小超过php.ini配置上限，值为4代表未接收到上传文件，值为6/7代表服务器临时目录无写入权限。
• 前端表单配置错误：上传文件的form表单必须添加enctype="multipart/form-data"属性，否则PHP无法解析上传的文件内容，$_FILES数组为空自然执行失败。如果开启了CI的CSRF校验，表单还需要携带合法CSRF令牌，否则请求会被框架直接拦截，无法走到文件处理逻辑。
• 文件名兼容问题：原始上传文件名如果包含中文、特殊字符、空格，部分服务器环境会出现写入失败，同时存在同名文件覆盖风险，建议存储时重命名文件，比如拼接时间戳、随机字符串生成新文件名。

修复后参考代码 #

// 先校验上传状态
if ($_FILES['file']['error'] !== UPLOAD_ERR_OK) {
    exit('文件上传失败，错误码：' . $_FILES['file']['error']);
}

$original_filename = $_FILES['file']['name'];
$file_tmp  = $_FILES['file']['tmp_name'];
// 生成安全的存储文件名，避免特殊字符、重名问题
$ext = pathinfo($original_filename, PATHINFO_EXTENSION);
$save_filename = time() . mt_rand(1000, 9999) . '.' . $ext;
$target_path = FCPATH . "profile_image/" . $save_filename;

// 执行移动并校验结果
if (move_uploaded_file($file_tmp, $target_path)) {
    echo '文件存储成功';
} else {
    echo '文件写入失败，请检查目录权限与路径配置';
}

提示：CI3自带封装完善的文件上传类，支持文件类型校验、大小限制、自动重命名等能力，稳定性和便利性都优于直接操作原生$_FILES，常规业务开发优先使用框架上传类即可。

内容的提问来源于stack exchange，提问作者sai sa