安装宝塔面板后,PHP默认的上传文件大小限制通常较低,当我们需要上传超过默认限制的文件时,就需要调整PHP.ini中的相关参数来放开限制。核心需要修改的参数包括upload_max_filesize和post_max_size,这两个参数直接决定了允许上传的文件最大大小。

需要修改的核心参数说明
在调整配置前,先了解两个核心参数的作用:
- upload_max_filesize:单个上传文件的最大允许大小,默认通常为2M。
- post_max_size:POST请求数据的最大大小,这个值需要大于等于upload_max_filesize,否则上传大文件时也会失败。
另外还有两个辅助参数可以根据需求调整:
- max_execution_time:脚本最大执行时间,上传大文件需要更长的执行时间,默认30秒可适当调大。
- max_input_time:接收POST数据的最大时间,默认60秒,大文件上传建议调大。
宝塔面板修改PHP.ini的具体步骤
步骤1:进入宝塔面板的PHP管理页面
登录宝塔面板后台,在左侧导航栏找到软件商店,在已安装软件列表中找到你当前网站使用的PHP版本,点击对应的设置按钮。
步骤2:修改配置参数
在PHP设置页面中,切换到配置修改选项卡,这里可以直接编辑PHP.ini的配置内容。我们可以通过搜索功能快速定位到需要修改的参数:
; 搜索找到以下参数,修改对应的值,比如设置为100M upload_max_filesize = 100M post_max_size = 100M max_execution_time = 300 max_input_time = 300
修改完成后点击页面底部的保存按钮。
步骤3:重载PHP配置
保存配置后,需要重载PHP服务让配置生效。在PHP设置页面切换到服务选项卡,点击重载配置按钮即可,不需要重启整个PHP服务。
通过phpinfo验证配置是否生效
修改完成后,我们可以创建一个PHP文件来验证配置是否生效。在网站根目录创建phpinfo.php文件,内容如下:
<?php phpinfo(); ?>
访问这个文件,搜索upload_max_filesize和post_max_size,查看对应的值是否已经变成我们设置的大小。验证完成后建议删除这个文件,避免暴露服务器信息。
常见问题说明
如果修改后配置没有生效,可以检查以下几点:
- 确认修改的是当前网站使用的PHP版本,不同PHP版本的配置文件是独立的。
- 确认post_max_size的值大于等于upload_max_filesize,否则上传限制会取两者中的较小值。
- 如果是Nginx环境,还需要检查Nginx配置中的
client_max_body_size参数,这个参数也需要设置大于等于上传文件的大小,修改后需要重载Nginx服务。
Nginx配置修改示例,在Nginx的站点配置中添加或修改如下内容:
server {
# 其他配置内容
client_max_body_size 100M;
# 其他配置内容
}
宝塔面板PHP.iniupload_max_filesizepost_max_size文件上传限制修改时间:2026-07-09 08:06:18