0

0

如何修改宝塔面板PHP上传大小限制?解决宝塔环境下大文件上传失败

P粉602998670

P粉602998670

发布时间:2026-03-17 18:24:11

|

440人浏览过

|

来源于php中文网

原创

宝塔面板中PHP网站上传大文件报413错误需同步调整PHP、Nginx或Apache的上传限制参数:一、修改php.ini中upload_max_filesize和post_max_size;二、Nginx配置client_max_body_size;三、Apache配置LimitRequestBody;四、用phpinfo()验证生效;五、排查SELinux、权限及防火墙干扰。

如何修改宝塔面板php上传大小限制?解决宝塔环境下大文件上传失败

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

一、修改PHP配置中的上传参数

PHP自身对上传文件大小有两处关键限制:upload_max_filesize控制单个文件最大允许体积,post_max_size控制整个POST请求体的最大容量,后者必须大于或等于前者。修改后需重启PHP服务生效。

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

2、在弹出窗口中切换到PHP版本选项卡,点击右侧设置(齿轮图标)。

立即学习PHP免费学习笔记(深入)”;

3、在PHP配置页面中,找到并点击配置文件链接,进入php.ini编辑界面。

4、使用Ctrl+F搜索关键词upload_max_filesize,将其值修改为所需大小,例如:upload_max_filesize = 2048M

5、继续搜索post_max_size,将其设为不小于upload_max_filesize的值,例如:post_max_size = 2048M

6、保存文件,返回PHP设置页面,点击重载配置或重启对应PHP版本服务。

二、调整Web服务器(Nginx)的客户端请求体限制

Nginx默认限制客户端请求体大小为1MB,若PHP层已放开但Nginx仍拦截,则需同步修改client_max_body_size参数。该设置需在站点配置或全局Nginx主配置中生效。

1、在宝塔面板中进入网站列表,点击目标站点右侧设置

2、切换至配置文件选项卡,定位到server { ... }区块内部。

3、在location ~ \.php$ {之前或server块首行附近插入一行:client_max_body_size 2048m;

4、确保该行未被注释(即前面无#号),保存配置文件。

5、点击页面右上角重载Nginx按钮使配置生效。

元典智库
元典智库

元典智库:智能开放的法律搜索引擎

下载

三、调整Apache环境下的LimitRequestBody参数

若站点使用Apache作为Web服务器,其上传限制由LimitRequestBody指令控制,该值以字节为单位,需在虚拟主机配置中显式设置,且须大于PHP设定的post_max_size。

1、在宝塔面板中打开目标站点的设置,切换到配置文件选项卡。

2、在<Directory区块内或VirtualHost块末尾添加:LimitRequestBody 2147483648(即2GB,单位为字节)。

3、确认该行未被注释,保存配置文件。

4、点击重载Apache使更改立即生效。

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

仅修改配置不等于实际生效,必须通过PHP脚本输出当前运行时参数,确认所有层级均已正确加载新值。此步骤可排除缓存、多PHP版本混淆或配置未加载等问题。

1、在网站根目录新建一个名为info.php的文件,内容为:<?php phpinfo(); ?>

2、通过浏览器访问http://您的域名/info.php,查找upload_max_filesizepost_max_size两项的实际值。

3、同时搜索Loaded Configuration File,确认显示的php.ini路径与您编辑的路径一致。

4、若Nginx环境,可在终端执行nginx -t验证语法,再执行nginx -s reload强制重载。

五、检查SELinux或防火墙对大文件上传的干扰

部分Linux系统启用SELinux后,可能限制HTTPD或PHP-FPM进程写入临时上传目录的权限;某些云服务器安全组或本地防火墙也可能对长时间上传连接进行超时中断。

1、执行命令getenforce检查SELinux状态,若返回Enforcing,临时设为宽容模式:setenforce 0,观察上传是否恢复。

2、检查PHP临时上传目录权限,运行php -i | grep upload_tmp_dir获取路径,再执行ls -ld /路径确认www用户有读写权限。

3、若使用云服务器,登录对应云平台控制台,检查安全组规则中HTTP/HTTPS端口是否开启长连接或允许大于60秒的会话持续时间

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

248

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

522

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

611

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

245

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

740

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3620

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

60

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

74

2026.01.13

抖漫入口地址合集
抖漫入口地址合集

本专题整合了抖漫入口地址相关合集,阅读专题下面的文章了解更多详细地址。

17

2026.03.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 13.7万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.4万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号