CodeIgniter 文件上传失败主因是 PHP 配置限制而非框架本身；需同步调整 upload_max_filesize、post_max_size、max_execution_time 等 php.ini 参数，并配合 CI 的 $config['max_size'] 校验与安全命名等设置。
本身不直接限制文件大小，真正卡住大文件上传的，是 PHP 底层配置和服务器环境。你调用
失败，大概率不是框架问题，而是
、
或
先扛不住了。
PHP 配置必须改，光调 CodeIgniter 参数没用
的
单位是 KB，但它只在文件**已成功提交到 PHP 临时目录后**才起作用。如果 PHP 在接收阶段就拒绝了，框架根本收不到文件。
必须 ≥ 你期望的最大单文件体积（如
）
必须 ≥
+ 表单其他字段开销（建议设为
）
和
要同步调高（比如
秒），否则大文件上传中途超时
确保
足够（至少
），尤其启用图片处理时
这些必须改
，
或
在运行时无效（
等属“PHP_INI_SYSTEM”级指令）。
CodeIgniter 配置要配合 PHP 设置做校验
不是摆设，它能防止用户绕过前端限制后上传超限文件——但前提是 PHP 已允许该文件进来。
设定值应略小于
（比如 PHP 设
，CI 设
KB），留出缓冲
启用
：避免同名覆盖，也减少因文件名含特殊字符导致的潜在失败
和
建议显式设为
和
，防止空格或重名引发静默错误
大文件上传失败时，先看
返回什么
常见错误信息对应真实原因：
→ PHP 的
或
不足
→ 可能是
触发，或某些安全扩展（如 Suhosin）拦截
→ 表单未用
，或
缺失
空白页或 500 错误 → 检查 PHP 错误日志，大概率是内存耗尽或超时，不是 CI 报错
上传过程中不要做 resize 或 image_lib 操作
对大图直接调
容易爆内存或超时，尤其 GD 库处理 >5MB 图片时。
先完成上传，拿到
中的
再用独立的异步任务、队列或 CLI 脚本处理缩略图（如 ImageMagick CLI）
如果必须同步处理，改用
扩展（比 GD 更省内存），并确保
≥ 图片体积 × 3
大文件上传的本质是协调 PHP 层、Web 服务器层（Nginx/Apache）、框架层三者的限制阈值。CI 的
类只是最后一道门禁，门没修好之前，反复调试门锁参数没意义。
CodeIgniter$this->upload->do_upload()post_max_sizeupload_max_filesizemax_execution_timeCodeIgniter$config['max_size']upload_max_filesize100Mpost_max_sizeupload_max_filesize110Mmax_execution_timemax_input_time300memory_limit256Mphp.ini.htaccessini_set()upload_max_filesize$config['max_size']upload_max_filesize100M102400encrypt_nameremove_spacesoverwriteTRUEFALSE$this->upload->display_errors()The uploaded file exceeds the maximum allowed size in your PHP configuration.upload_max_filesizepost_max_sizeThe upload was stopped by extension.max_execution_timeYou did not select a file to upload.form_open_multipart()enctype="multipart/form-data"$this->image_lib->resize()$this->upload->data()full_pathimagickmemory_limitupload