ThinkPHP导入Excel如何限制文件大小 设置教程

处理Excel导入时，最常见的坑就是文件大小限制。你辛辛苦苦写好了导入逻辑，结果上传一个稍微大点的文件，要么直接弹出“文件过大”的错误，要么悄无声息地被截断，数据只进来一半。更麻烦的是，这个问题通常不是单一原因造成的，而是PHP底层、Web服务器和框架三层配置需要协同作战，缺一不可。只改其中任何一层，另外两层照样会卡住请求，导致上传失败或数据不完整。

修改PHP核心上传参数

PHP在解析请求之前，会先强制校验两个硬性参数：upload_max_filesize控制单个文件的上限，post_max_size则控制整个POST请求体（包括所有字段和文件）的总大小。这两个参数必须同时调大，而且post_max_size必须大于upload_max_filesize，否则即便只上传一个Excel文件，也可能被截断。

首先，用phpinfo()确认当前生效的php.ini路径，这一步很关键——千万别改错了配置文件。

然后，打开正确的php.ini，找到并修改这两行：
upload_max_filesize = 50M
post_max_size = 60M

注意，单位支持M或K，但不能写成“50MB”或“50m”，大小写敏感。

另外，还得检查一下max_execution_time，建议设置为≥300。大Excel解析起来比较耗时，如果超时了，报的会是504 Gateway Timeout，而不是文件大小错误，容易误导排查方向。

保存修改后，务必执行systemctl restart php-fpm（或对应的版本命令），然后刷新phpinfo页面验证数值是否已更新——只改文件不重启服务，配置相当于没改。

配置Nginx或Apache请求体限制

Nginx或Apache会在请求抵达PHP之前，独立检查请求体大小。如果这里没有放宽限制，请求会直接被拦截，返回413错误，PHP日志里甚至根本不会记录这次请求。

方法一（Nginx）：
编辑站点server块的配置文件，在location ~ \.php$ {}内部添加：
client_max_body_size 60M;
千万别把这条指令写到http全局块里，否则会影响所有虚拟主机。

方法二（Apache）：
在虚拟主机配置或项目根目录的.htaccess文件中，添加LimitRequestBody指令，单位是字节：
LimitRequestBody 62914560（即60MB）
如果.htaccess被禁用了，那就必须直接改vhost配置文件。

修改完成后，执行nginx -t && nginx -s reload验证并重载Nginx；Apache则运行apachectl graceful。这一步如果漏掉，前端上传界面可能会卡死无响应，用户完全不知道发生了什么。

设置ThinkPHP框架层校验规则

框架层的校验属于应用逻辑级别的预检，仅在PHP成功接收文件后触发。它的作用是细化业务规则（比如对某个字段单独限制），不能替代底层配置。但必须显式调用validate()才能生效。

在控制器中获取上传对象后，立刻调用validate方法：

$file = $this->request->file('excel');
$file->validate(['size' => 52428800, 'ext' => ['xlsx', 'xls']]);

这里注意，size的单位是字节，不是M或MB；ext的值必须全小写，且不含点号。如果使用的是新版ThinkPHP 6.x的Filesystem组件，还需要检查config/filesystem.php中disk驱动是否启用了max_size选项，并设为整数。

对于旧版ThinkPHP 3.2，需要在Upload类实例化时传入maxSize参数，例如：
new ThinkUpload(['maxSize' => 52428800])。

一句话总结：上传Excel的限制问题，本质是三层配置的联动。PHP管接收，Web服务器管入口，框架管业务校验。每一层都不能落下，才能让导入功能稳定可靠。