提升PHP上传速度的宝塔优化方法

宝塔面板下PHP上传卡在100%、速度慢或中途失败，往往并非网络问题，而是关键配置失配所致：upload_max_filesize与post_max_size单位写错（必须用M而非MB）、数值不匹配（后者需至少比前者大16M），Nginx的client_max_body_size未同步调整，PHP-FPM进程数不足导致并发排队，以及被宝塔隐藏的request_terminate_timeout设为0引发上传中断；更反直觉的是，盲目拉高max_execution_time反而易触发中间件超时，合理设为120秒更稳定——每一处细节都可能成为上传瓶颈，精准调优后配合curl实测，才能真正释放上传性能。

PHP上传卡在100%但实际没完成？检查 upload_max_filesize 和 post_max_size

宝塔装完默认值太保守，upload_max_filesize 是单文件上限，post_max_size 是整个 POST 请求体总大小——后者必须 ≥ 前者，否则大文件上传直接被 PHP 截断，浏览器可能卡在 100%，但服务端根本没收到完整数据。

• upload_max_filesize 建议设为 256M 或更高（根据业务定），不能写成 256MB，单位只认 M、G（注意大小写）
• post_max_size 至少比 upload_max_filesize 大 16M，比如设 272M，留出表单字段等额外开销
• 改完必须重启 php-fpm，光重载不生效；宝塔里点“重载配置”或执行 bt 18
• 别只改 php.ini 主配置——如果站点启用了「PHP 扩展配置」或「用户自定义 php.ini」，优先级更高，得同步改那里

上传慢还卡顿？调低 max_execution_time 反而更稳

很多人以为上传大文件就得把 max_execution_time 拉到 300 秒甚至 600 秒，结果反而更容易超时失败。PHP 默认是 30 秒，但上传过程本身不计入执行时间（由底层 SAPI 控制），真正卡住的是上传完成后脚本处理阶段。过长的 timeout 容易让 Nginx 或浏览器误判连接异常。

• 建议设为 120（秒），够用且不易触发中间件超时
• 同时检查 Nginx 的 client_max_body_size，它必须 ≥ post_max_size，否则请求在进入 PHP 前就被 Nginx 拒绝，错误日志里会看到 413 Request Entity Too Large
• 宝塔里修改 Nginx 配置后，记得点「重载 Web 服务」，不是「重载配置」

并发上传变慢？调整 pm.max_children 和 pm.start_servers

PHP-FPM 进程不够，多个上传请求排队等 worker，表现就是上传速度忽快忽慢、响应延迟高。宝塔默认用 dynamic 模式，但初始值偏低，尤其在低配机器上容易成为瓶颈。

• 先看当前负载：sudo -u www /www/server/php/80/bin/php-fpm -t 然后查 pm.status_path 对应的 FPM 状态页，观察 active processes 和 max active processes
• 若活跃进程常接近 max_children，就把 pm.max_children 提到 50（2G 内存机器起步），pm.start_servers 设为 10，避免冷启动抖动
• 别盲目拉高 pm.max_requests（比如设成 10000）——内存泄漏风险会放大，建议保持默认 1000 或略调高到 2000
• 改完务必执行 systemctl reload php-fpm-80（版本号按你实际用的填），service php-fpm reload 在宝塔环境可能不生效

上传中途断连？确认 request_terminate_timeout 没被宝塔隐藏覆盖

这个参数不在标准 php.ini 里，而是 PHP-FPM pool 配置项（如 /www/server/php/80/etc/php-fpm.d/www.conf），宝塔界面不暴露它，但某些版本的宝塔模板会默认写死为 0s（即禁用），导致上传中网络抖动时连接被意外终止。

• 打开对应版本的 www.conf，搜 request_terminate_timeout，如果值是 0，改成 300s
• 该参数和 max_execution_time 不同：它控制整个请求生命周期（含上传阶段）的硬性超时，对不稳定网络更关键
• 改完一定要 systemctl restart php-fpm-80，reload 不会重读这个 timeout 值
• 注意：如果用了宝塔的「PHP 插件 > 防跨站攻击」，它会注入额外限制，上传异常时先临时关闭它测试是否冲突

上传速度不单看 PHP 参数，Nginx 缓冲区、磁盘 I/O、客户端网络质量都在链路上。改完任何一项，都建议用 curl -F "file=@test.zip" http://yoursite.com/upload.php 实测，别只靠浏览器上传界面判断。

好了，本文到此结束，带大家了解了《提升PHP上传速度的宝塔优化方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！