如何配置ThinkPHP中的文件上传大小限制？

本文共计896个文字，预计阅读时间需要4分钟。

如果在ThinkPHP项目中遇到文件上传失败、提示Post size exceeded或直接返回413错误，通常不是框架本身的问题，而是底层PHP与Web服务器对请求大小的限制不同步所致。以下是一些解决步骤：

一、调整PHP核心上传参数

PHP在解析HTTP请求前会强制校验两个关键配置：upload_max_filesize控制单文件上限，post_max_size控制整个POST请求体（含所有字段+文件）总大小。二者必须同时调大，且post_max_size必须大于等于upload_max_filesize，否则即使只传一个文件也会被截断。

1、定位并编辑php.ini文件，查找以下两行配置项。

2、将upload_max_filesize设为预期最大单文件大小，例如：upload_max_filesize = 20M。

立即学习“PHP免费学习笔记（深入）”；

3、将post_max_size设为略大值以容纳表单其他字段，例如：post_max_size = 25M。

4、保存后执行systemctl restart php-fpm（或对应版本命令），确保服务完全重启。

5、访问phpinfo()页面，确认两项数值已更新生效，不可仅依赖配置文件修改。

二、配置Nginx请求体限制

Nginx在将请求转发给PHP前，独立执行client_max_body_size检查。默认值仅为1MB，若未显式配置，超限请求将直接返回413错误，PHP层根本无法介入处理。

1、进入Nginx站点配置文件，定位到对应server块或location块内。

2、添加指令：client_max_body_size 25M;。

3、禁止将其写入http全局块，以免影响其他站点。

4、执行nginx -t验证语法，再运行nginx -s reload重载配置。

5、若使用反向代理或云负载均衡（如ALB/SLB），需同步检查上游网关是否设置body size限制。

三、配置Apache请求体限制

Apache通过LimitRequestBody指令控制请求体大小，默认不限制；但若虚拟主机或.htaccess中曾设置该值（如防DOS攻击），则可能意外拦截上传请求，其作用机制与Nginx的client_max_body_size完全一致。

1、打开Apache虚拟主机配置文件或项目根目录下的.htaccess。

2、查找LimitRequestBody指令，确认其值是否小于预期上传大小。

3、若存在且过小，修改为：LimitRequestBody 26214400（即25MB，单位为字节）。

4、若无该指令，可手动添加于或块内。

5、重启Apache服务：systemctl restart apache2或httpd。

四、设置ThinkPHP框架层校验规则

框架层验证仅在PHP成功接收并生成$_FILES后才触发，属于二次校验，不能替代底层配置。其fileSize规则要求传入整数字节值，字符串单位（如'2M'）将静默失效。

1、在控制器中定义验证规则数组，例如：$rule = ['file' => 'fileSize:2097152|fileExt:jpg,png,pdf'];

2、确保该规则应用于think\Validate实例或直接传入File对象的validate()方法。

3、注意size单位为字节，2097152 = 2 × 1024 × 1024，不可写作'fileSize'=>'2M'。

4、若需区分多字段限制（如头像≤2MB、附件≤20MB），须为每个字段单独声明fileSize规则。

5、空文件（size=0）默认通过fileSize校验，如需禁止，额外添加require规则。

五、修改ThinkPHP旧版Upload类参数

针对ThinkPHP 3.x等旧版本，其ORG/Net/UploadFile类提供maxSize属性直接控制单文件上限，该值仅在框架接收文件后生效，仍需前置PHP与Web服务器配置支撑。

1、在上传逻辑中实例化UploadFile对象：$upload = new UploadFile();

2、设置maxSize属性为字节数，例如：$upload->maxSize = 2097152;。

3、同时设置allowExts指定允许扩展名，savePath指定存储路径。

4、调用$upload->upload()执行上传，失败时通过$upload->getErrorMsg()获取提示。

5、该方式不适用于ThinkPHP 6+，新版应统一使用validate()配合File对象。