PHP 上传大文件需同步调整 php.ini 中 upload_max_filesize、post_max_size、max_execution_time 和 memory_limit 四项配置,并重启 Web 服务;还需检查 Nginx 的 client_max_body_size 或 Apache 的 mod_security 限制。

PHP 安装后默认限制上传文件大小(通常为 2MB),改不了就传不了大文件——这问题不是 PHP 没装好,而是 php.ini 里几个关键配置没调对。改错一个,上传照样失败。
怎么确认当前上传限制值?
先别急着改配置,用 phpinfo() 看清实际生效的值。新建一个 info.php 文件,内容:
浏览器 访问后搜索 upload_max_filesize、post_max_size、max_execution_time 和 memory_limit 这几项,注意看“Loaded Configuration File”路径,确保你编辑的是这个 php.ini 文件,而不是其他位置的副本。
必须同时改的四个配置项
只改 upload_max_filesize 是无效的。PHP 上传流程会依次受以下四项约束,任一卡住都会报错(比如 ERR_CONNECTION_RESET 或直接返回空数组):
立即学习“PHP 免费学习笔记(深入)”;
-
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 默认值,而是多个层级配置没对齐,或者改了但没重启对应服务。每次只动一个变量,验证一次,比全改完再试更省时间。






























