如何在后端提前拦截大文件上传并实现自定义错误提示？

一、关于「上传前后端验证文件大小」的本质 #

HTTP协议里，服务器在接收文件前只能拿到客户端发送的Content-Length请求头，但这个值是可以被篡改的，没法作为真实文件大小的依据。所以不存在绝对可靠的「上传前后端验证文件大小」方案——你没法在完全不接收文件的情况下，100%确认文件实际大小。

二、用PHP配置拦截超大文件：高效且可靠 #

设置post_max_size和upload_max_filesize是目前最节省服务器资源的方案，以下是关键细节：

1. 上传超大文件时的服务器行为 #

当你把两个参数都设为40M，用户上传10GB文件时，服务器不会接收完整文件：PHP会在接收的数据量达到post_max_size限制时立即中断请求，不会继续接收剩余内容，彻底避免带宽和服务器资源的浪费。

注意：post_max_size的值必须大于等于upload_max_filesize，因为POST请求除了文件，还可能包含其他表单字段的数据。

2. 隐藏默认警告并显示自定义错误 #

默认的POST Content-Length exceeds limit警告是PHP在全局层面抛出的，没法通过常规脚本捕获，需要分两步处理：

• 第一步：关闭错误输出到页面
  在生产环境的php.ini中配置：

  display_errors = Off
  log_errors = On
  error_log = /var/log/php/upload_errors.log
  

  这样默认警告只会写入服务器日志，不会暴露给用户。

• 第二步：在脚本中捕获上传错误并返回自定义提示
  文件上传被配置拦截时，$_FILES['input_name']['error']会被设为UPLOAD_ERR_INI_SIZE（对应值为1），你可以在上传处理脚本里判断这个错误码，输出自定义内容：

  if (isset($_FILES['input_name']) && $_FILES['input_name']['error'] === UPLOAD_ERR_INI_SIZE) {
      header('HTTP/1.1 400 Bad Request');
      echo "上传文件过大，最大允许40MB";
      exit;
  }
  

• 如果你没有权限修改全局php.ini，可以用Apache的.htaccess（或Nginx的fastcgi参数）配置：

  php_value post_max_size 40M
  php_value upload_max_filesize 40M
  php_flag display_errors Off
  

三、补充：前端验证提升用户体验 #

虽然前端验证可被绕过，但可以先做一层拦截，减少不必要的请求：

const fileInput = document.querySelector('#your-file-input');
fileInput.addEventListener('change', function(e) {
    const selectedFile = e.target.files[0];
    const maxAllowedSize = 40 * 1024 * 1024; // 40MB
    if (selectedFile.size > maxAllowedSize) {
        alert('文件过大，仅支持40MB以内的文件');
        fileInput.value = ''; // 清空已选文件
    }
});

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