宝塔PHP上传限制修改教程

本文详细讲解了在宝塔面板环境下解决大文件上传失败问题的完整方案，针对“413 Request Entity Too Large”、文件截断等常见错误，系统梳理了PHP层（upload_max_filesize、post_max_size等参数）、Nginx层（client_max_body_size）和Apache层（LimitRequestBody）三重限制的同步修改步骤，并强调配置保存后必须重启服务与实测验证，确保每一步精准生效——无论你是新手站长还是运维人员，只需按步操作，即可安全、稳定地开启数百兆乃至更大文件的上传支持。

如果您在宝塔面板中运行PHP网站，上传大文件时提示“413 Request Entity Too Large”或文件被截断、无法完整上传，则很可能是PHP或Nginx/Apache的上传限制参数未同步调整。以下是修改宝塔面板PHP上传大小限制的具体操作步骤：

一、修改PHP配置中的upload_max_filesize和post_max_size

PHP自身对单个文件上传大小（upload_max_filesize）和整个POST请求体最大尺寸（post_max_size）设有默认限制，需手动调高以支持大文件上传。该配置直接影响PHP脚本能否接收完整数据。

1、登录宝塔面板，在左侧菜单点击网站，找到对应站点，点击右侧设置按钮。

2、在弹出窗口中切换到PHP版本选项卡，点击右侧配置文件链接（图标为齿轮形状）。

3、在打开的php.ini编辑器中，使用Ctrl+F搜索upload_max_filesize，将其值修改为所需大小，例如：upload_max_filesize = 512M。

4、继续搜索post_max_size，确保其值不小于upload_max_filesize，推荐设为：post_max_size = 512M。

5、同时检查max_execution_time和max_input_time，建议设为较大值以防超时中断，例如：max_execution_time = 300、max_input_time = 300。

6、点击右上角保存，返回PHP版本页面，点击重启PHP服务使配置生效。

二、调整Web服务器（Nginx）的client_max_body_size

Nginx作为反向代理层，默认限制客户端请求体大小为1MB，若PHP已放宽限制但Nginx未同步，仍会返回413错误。必须在站点配置中显式扩大该值。

1、回到该站点的设置页面，切换至配置文件选项卡。

2、在server块内、location ~ \.php(.*)$ 段落上方或同级位置，插入以下指令：

client_max_body_size 512M;

3、若配置中已存在该指令，直接修改其数值为匹配PHP的大小（如512M），确保无拼写错误且未被注释。

4、点击保存，然后点击页面顶部的重载Nginx按钮。

三、调整Apache环境下的LimitRequestBody

若站点使用Apache而非Nginx，其请求体限制由LimitRequestBody指令控制，需在虚拟主机配置或.htaccess中设置，否则即使PHP配置正确也无法上传大文件。

1、在站点设置中切换到配置文件选项卡，确认当前Web服务器为Apache。

2、在段落内（通常位于中），添加或修改如下行：

LimitRequestBody 536870912

3、该数值单位为字节，536870912 = 512 × 1024 × 1024，即512MB；请勿使用“M”后缀，仅允许纯数字。

4、保存配置后，点击重载Apache使更改生效。

四、验证上传限制是否生效

修改完成后，需通过实际测试确认各层级限制均已解除，避免因缓存或配置遗漏导致上传仍失败。

1、在网站根目录新建一个PHP探针文件，例如info.php，内容为：。

2、通过浏览器访问http://您的域名/info.php，查找upload_max_filesize、post_max_size、max_execution_time等字段，确认显示值与修改一致。

3、删除info.php文件，防止信息泄露。

4、使用网站自带的上传功能或自建测试表单提交一个略小于设定上限的文件（如500MB），观察是否成功完成且无报错。

到这里，我们也就讲完了《宝塔PHP上传限制修改教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！