PHP sha1_file处理5MB以上文件时出现警告问题求助

我来帮你搞定这个上传头像的问题！你遇到的大文件超过5MB就触发sha1_file报错的情况，十有八九是PHP的上传配置限制在搞怪，咱们一步步排查解决：

这是最常见的根源——当上传文件超过PHP允许的最大值时，PHP会直接丢弃这个文件，导致$_FILES['你的文件字段名']['tmp_name']变成空值，sha1_file自然就报“Filename cannot be empty”了。你需要重点检查两个关键配置：

• upload_max_filesize：单个上传文件的最大允许大小，默认通常是2MB或8MB，你的情况是5MB触发问题，说明这个值大概率设成了5MB；
• post_max_size：整个POST请求的最大大小，这个值必须大于等于upload_max_filesize，因为POST请求里除了文件还可能包含其他表单数据。

修改方法：

1. 找到你的PHP配置文件（通常是php.ini，虚拟主机用户可以在控制面板找配置入口）；
2. 调整参数值，比如：

   upload_max_filesize = 10M
   post_max_size = 12M
   

3. 重启Web服务器（Apache/Nginx）让配置生效。

别漏了给上传表单加上enctype="multipart/form-data"！没有这个属性的话，大文件上传可能会出现异常，导致服务器无法正确接收文件：

<form method="post" action="你的上传脚本.php" enctype="multipart/form-data">
  <input type="file" name="avatar">
  <button type="submit">上传头像</button>
</form>

在调用sha1_file之前，先检查文件是否上传成功，避免传递空值。比如：

// 假设你的文件输入字段名是avatar
if ($_FILES['avatar']['error'] !== UPLOAD_ERR_OK) {
    // 根据错误码给用户明确提示
    switch ($_FILES['avatar']['error']) {
        case UPLOAD_ERR_INI_SIZE:
            echo "上传文件超过了PHP配置的最大限制";
            break;
        case UPLOAD_ERR_FORM_SIZE:
            echo "上传文件超过了表单设置的最大限制";
            break;
        default:
            echo "文件上传失败，错误码：" . $_FILES['avatar']['error'];
    }
    exit;
}

// 确认临时文件路径不为空再计算哈希
if (!empty($_FILES['avatar']['tmp_name'])) {
    $file_hash = sha1_file($_FILES['avatar']['tmp_name']);
    // 后续的头像存储、数据库更新逻辑
} else {
    echo "无法获取上传文件的临时存储路径";
}

这样不仅能避免sha1_file的错误，还能给用户清晰的反馈。

有些Web服务器（比如Nginx）自身也有上传大小限制，比如Nginx的client_max_body_size参数，如果这个值比PHP的post_max_size小，会直接拦截大文件请求。你可以在Nginx配置文件里修改：

client_max_body_size 12M;

修改后重启Nginx即可生效。

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