php上传文件大小限制的相关配置项
php的上传文件大小限制由多个配置项共同控制,只修改其中一个往往无法达到预期效果,首先需要了解这几个核心配置项的含义:
- upload_max_filesize:表示单个上传文件的最大允许大小,默认通常是2M。
- post_max_size:表示通过POST方式提交的数据最大大小,因为文件上传是通过POST请求完成的,所以这个值必须大于upload_max_filesize,一般建议设置为upload_max_filesize的1到2倍。
- upload_tmp_dir:上传文件的临时存放目录,需要确保该目录有写入权限,一般使用默认配置即可。
- max_file_uploads:表示单次请求最多允许上传的文件数量,默认是20,根据业务需求调整即可。
修改php.ini配置文件调整限制
这是最常用也是最彻底的修改方式,适合拥有服务器配置权限的场景,具体操作步骤如下:
1. 找到php.ini配置文件
可以通过php的phpinfo()函数查看当前php.ini的路径,创建如下测试文件访问即可:
<?php phpinfo(); ?>
在输出页面中搜索Loaded Configuration File,对应的值就是当前生效的php.ini文件路径。
2. 修改配置项
打开php.ini文件,找到对应的配置项进行修改,比如要允许上传最大100M的文件,可以调整为:
upload_max_filesize = 100M post_max_size = 120M max_file_uploads = 20 upload_tmp_dir = /tmp/php_upload
修改完成后保存文件,注意如果是生产环境,修改前最好备份原配置文件。
3. 重启服务生效
修改php.ini后需要重启对应的服务才能让配置生效:
- 如果是apache服务器,重启apache服务即可,比如执行systemctl restart httpd或者service apache2 restart。
- 如果是nginx+php-fpm架构,需要重启php-fpm服务,比如执行systemctl restart php-fpm。
无php.ini修改权限时的临时调整方式
如果是在虚拟主机等没有php.ini修改权限的场景,可以尝试通过以下方式临时调整,不过这种方式不一定所有环境都支持:
1. 通过.htaccess文件修改(apache环境)
在网站根目录创建或编辑.htaccess文件,添加如下内容:
php_value upload_max_filesize 100M php_value post_max_size 120M php_value max_file_uploads 20
2. 通过.user.ini文件修改
在网站根目录创建.user.ini文件,添加如下内容:
upload_max_filesize = 100M post_max_size = 120M max_file_uploads = 20
这种方式需要php开启了user_ini.cache配置,修改后可能需要等待几秒到几分钟才会生效。
3. 通过代码动态修改
在上传文件的脚本开头通过ini_set函数修改,不过这种方式只能修改部分配置项,upload_max_filesize和post_max_size通常无法通过ini_set修改:
<?php
// 仅部分配置项支持动态修改,上传大小相关配置大多不支持
ini_set('upload_max_filesize', '100M');
ini_set('post_max_size', '120M');
?>
验证配置是否生效
修改完成后,再次访问之前的phpinfo测试页面,搜索对应的配置项,查看对应的值是否已经变成修改后的数值,如果已经更新说明配置生效。如果值没有变化,需要检查修改的php.ini是否是当前生效的配置文件,或者是否重启了对应的服务。
注意事项
- post_max_size的值一定要大于upload_max_filesize,否则上传大文件时会先触发post数据大小限制报错。
- 如果上传的文件仍然超过限制,需要检查web服务器是否有额外的大小限制,比如nginx的client_max_body_size配置,默认是1M,也需要同步调整。
- 修改配置时要根据实际业务需求设置合理的大小,不要盲目设置过大,避免占用过多服务器资源。

phpupload_max_filesizepost_max_sizephp.ini文件上传配置修改时间:2026-07-10 10:51:11