宝塔面板修改上传限制方法

宝塔面板上传文件失败？别再盲目修改配置了！真正有效的上传限制调整必须同步搞定PHP层（upload_max_filesize和post_max_size）、Web服务器层（Nginx的client_max_body_size或Apache的LimitRequestBody）以及关键的重启与验证环节——仅改php.ini却不重启PHP服务、或忽略Web服务器拦截，90%的情况都会失效；本文手把手教你用宝塔界面安全操作、避开多版本PHP配置混淆陷阱，并通过实测报错精准定位卡点，让大文件上传一次调通。

宝塔面板里改上传限制，本质是改 PHP 的 upload_max_filesize 和 post_max_size 两个值，但只改 php.ini 文件不够——必须通过宝塔界面操作或重启 PHP 服务，否则修改不生效。

在宝塔面板里直接修改 PHP 配置（推荐）

这是最安全、最不容易出错的方式。宝塔会自动校验值的合法性，并写入对应版本的 php.ini，还顺带帮你重启 PHP。

• 进入「软件商店」→ 找到已安装的 PHP 版本（如 PHP-7.4 或 PHP-8.2）→ 点击「设置」
• 切换到「配置修改」选项卡，找到 upload_max_filesize 和 post_max_size 这两项
• post_max_size 必须 ≥ upload_max_filesize，常见配对是：upload_max_filesize = 128M，post_max_size = 150M
• 改完点「保存」，宝塔会提示「正在重启 PHP 服务」，等状态变绿即生效

手动编辑 php.ini 文件的注意事项

如果你用命令行或 FTP 直接改了 /www/server/php/XX/etc/php.ini，但上传还是失败，大概率是因为没重启 PHP 或改错了位置。

• 确认你编辑的是当前网站所用 PHP 版本的 php.ini（比如站点用 PHP-8.1，就别去改 PHP-7.4 的文件）
• 检查是否漏改 max_execution_time 和 max_input_time：大文件上传耗时长，建议设为 300 或更高
• 改完必须执行 service php-fpm-XX restart（XX 是版本号，如 81），或在宝塔界面点「重载配置」
• 用 php -i | grep "Loaded Configuration File" 确认实际加载的 php.ini 路径，避免改错文件

上传仍失败？检查 Nginx/Apache 的请求体限制

PHP 层面调大了，但 Web 服务器可能拦在前面。宝塔默认对 Nginx 做了 client_max_body_size 限制，Apache 则看 LimitRequestBody。

• Nginx 场景：进入「网站」→ 点击对应站点 → 「配置文件」→ 在 server 块内加入 client_max_body_size 128m;（注意单位是 m，不是 M）
• Apache 场景：同上进配置文件，在 或 内加 LimitRequestBody 134217728（单位是字节，128MB = 134217728）
• 改完必须点击「保存」并「重载 Nginx」或「重启 Apache」，否则不生效

验证修改是否真正生效

别只信 phpinfo() 页面显示的值，要实测。上传一个略大于设定值的文件（比如设了 128M，就传个 130MB 的 zip），观察报错类型：

• 报 413 Request Entity Too Large → Nginx 层拦截，回头查 client_max_body_size
• 报 Unknown error 或页面空白 → PHP 超时，检查 max_execution_time 和 max_input_time
• 报 File upload error: 1 → upload_max_filesize 或 post_max_size 不够，或没重启 PHP
• 用 php -r "echo ini_get('upload_max_filesize').PHP_EOL;" 在终端验证 CLI 模式下的值（注意：CLI 和 FPM 可能用不同 php.ini）

最容易被忽略的是：改完 PHP 配置后忘记重载 Web 服务，或者多个 PHP 版本共存时改错了目标版本的 php.ini。上传限制是 PHP + Web 服务器 + 浏览器超时三者共同作用的结果，少一个环节都可能卡住。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~