PHP大文件上传返回空数组（错误码7）问题求助

问题描述 #

上传小于2GB的文件一切正常，但上传超过2GB的文件时，返回包含错误码7的数组：

array(1) { 
    ["file"]=> array(5) { 
        ["name"]=> string(15) "12345648465.mp4" 
        ["type"]=> string(0) "" 
        ["tmp_name"]=> string(0) "" 
        ["error"]=> int(7) 
        ["size"]=> int(0) 
    } 
} 

服务器环境为WHM & CPanel搭配CentOS7，已调整memory_limit、post_max_size等参数，但问题依旧，PHP和Apache日志无相关报错。

错误码7的核心原因 #

PHP错误码7对应UPLOAD_ERR_CANT_WRITE，表示文件无法写入临时目录，通常由临时目录权限不足、磁盘空间不足，或文件系统/服务器层面的大小限制导致。

解决方案 #

1. 检查PHP临时目录的权限与空间 #

• 执行phpinfo()查看upload_tmp_dir参数，确认PHP使用的临时目录路径
• 确保该目录对PHP运行用户（通常是apache、nobody或www-data）拥有读写权限，权限设置为700或755
• 检查临时目录所在磁盘的剩余空间，确保有足够空间存放待上传的大文件

2. 统一PHP上传参数配置 #

当前.htaccess中post_max_size=4G小于upload_max_filesize=20G，post_max_size必须大于等于upload_max_filesize，否则会被前者限制上传大小：

• 修改.htaccess中post_max_size为20G或更大（比如25G）
• 优先通过WHM的MultiPHP INI Editor或CPanel的PHP Selector修改配置，避免.htaccess配置不生效的情况

3. 检查服务器级别的限制 #

• 临时关闭ModSecurity测试：在WHM的ModSecurity Tools中禁用规则，确认是否是安全模块拦截了大文件上传
• 确认Apache的limitRequestBody配置：当前设置为5368709120（5GB），足够容纳2GB以上文件，需确保该配置生效
• 查看WHM的Tweak Settings，确认全局文件上传限制未设置过低

4. 检查临时目录的文件系统限制 #

• 用df -T命令查看临时目录所在的文件系统类型：
  • 如果是ext3，默认单文件最大限制为2GB，需重新格式化文件系统并启用large_file支持，或更换为ext4/xfs文件系统
  • 用tune2fs -l /dev/[磁盘设备名] | grep "Max file size"检查ext文件系统的最大文件限制

5. 代码优化（可选） #

大文件上传建议采用分片上传方案，避免一次性上传的各种限制：

• 将前端文件分割为多个小块（比如每块100MB），逐个上传
• 后端接收分片后拼接为完整文件
• 增加错误处理逻辑，明确提示错误原因：

  if(isset($_POST['submit'])){
      if($_FILES['file']['error'] !== UPLOAD_ERR_OK){
          switch($_FILES['file']['error']){
              case UPLOAD_ERR_CANT_WRITE:
                  die('临时目录写入失败，请检查权限和磁盘空间');
              case UPLOAD_ERR_INI_SIZE:
                  die('文件大小超过php.ini限制');
              // 其他错误码处理
          }
      }
      // 后续上传逻辑
  }
  

内容的提问来源于stack exchange，提问作者Moayad Shloul