PHP修改上传文件大小限制方法

PHP上传大文件失败往往并非程序缺陷，而是因php.ini中upload_max_filesize、post_max_size、max_execution_time和memory_limit四项配置未同步调整，且常被忽略Web服务器层（如Nginx的client_max_body_size或Apache的mod_security）的额外限制；正确排查需先用phpinfo()定位生效的配置文件，逐项修改并严格满足约束关系（如post_max_size必须≥upload_max_filesize，memory_limit需≥post_max_size），再重启对应服务，并结合错误日志精准定位瓶颈——多层配置需对齐，改动后必重启，验证时建议单点调整、逐步确认，才能真正打通大文件上传全链路。

PHP 安装后默认限制上传文件大小（通常为 2MB），改不了就传不了大文件——这问题不是 PHP 没装好，而是 php.ini 里几个关键配置没调对。改错一个，上传照样失败。

怎么确认当前上传限制值？

先别急着改配置，用 phpinfo() 看清实际生效的值。新建一个 info.php 文件，内容：

<?php phpinfo(); ?>

浏览器访问后搜索 upload_max_filesize、post_max_size、max_execution_time 和 memory_limit 这几项，注意看 “Loaded Configuration File” 路径，确保你编辑的是这个 php.ini 文件，而不是其他位置的副本。

必须同时改的四个配置项

只改 upload_max_filesize 是无效的。PHP 上传流程会依次受以下四项约束，任一卡住都会报错（比如 ERR_CONNECTION_RESET 或直接返回空数组）：

• upload_max_filesize：单个文件最大允许大小（如 50M）
• post_max_size：整个 POST 请求体上限，必须 ≥ upload_max_filesize（建议设为 55M 预留缓冲）
• max_execution_time：脚本最长执行时间（大文件上传慢，设为 300 或更高）
• memory_limit：脚本可用内存，需 ≥ post_max_size（例如设为 64M）

在 php.ini 中修改（不要加引号）：

upload_max_filesize = 50M
post_max_size = 55M
max_execution_time = 300
memory_limit = 64M

改完不生效？重启服务和检查错误日志

改完 php.ini 后必须重启 Web 服务（Apache/Nginx + PHP-FPM），否则配置不会加载：

• Apache：运行 sudo systemctl restart apache2（或 httpd）
• Nginx + PHP-FPM：运行 sudo systemctl restart php-fpm 和 sudo systemctl restart nginx

如果仍失败，检查 PHP 错误日志（路径见 phpinfo() 中的 error_log）——常见报错如：PHP Warning: POST Content-Length of XXX bytes exceeds the limit of YYY bytes，说明 post_max_size 还是不够；或者 Failed to write session data，可能是 session.save_path 权限或磁盘空间问题。

Web 服务器层也可能拦截大文件

PHP 配置只是后端一环，Nginx/Apache 自身也有上传限制：

• Nginx：检查 client_max_body_size（在 http、server 或 location 块中），必须 ≥ PHP 的 post_max_size，例如：client_max_body_size 60M;
• Apache：若用了 mod_security，可能拦截大 POST，临时禁用测试或调 SecRequestBodyLimit

改完 Nginx 配置要 sudo nginx -t && sudo systemctl reload nginx；Apache 则需 sudo apachectl configtest && sudo systemctl reload apache2。

真正卡住上传的往往不是 PHP 默认值，而是多个层级配置没对齐，或者改了但没重启对应服务。每次只动一个变量，验证一次，比全改完再试更省时间。

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