在使用PHP开发文件上传功能时，默认配置下上传超过2M的文件往往会失败，这主要是因为PHP的默认配置对上传文件大小做了限制，核心相关的两个配置项是upload_max_filesize和post_max_size。
两个核心配置项的作用
要解决问题首先需要明确两个配置项的具体作用：
- upload_max_filesize：该配置项用于限制单个上传文件的最大大小，PHP默认值为2M，这也是超过2M文件上传失败的直接原因之一。
- post_max_size：该配置项用于限制通过POST方法提交的数据的最大大小，文件上传的数据是通过POST请求传输的，所以这个值必须大于等于upload_max_filesize的值，否则即使upload_max_filesize设置得再大，也会因为POST数据总大小超限导致上传失败。
查看当前配置值的方法
在修改配置之前，可以先查看当前PHP的这两个配置项的值，新建一个PHP文件，写入以下代码：
<?php
// 查看upload_max_filesize配置值
echo "upload_max_filesize: " . ini_get("upload_max_filesize") . "<br/>";
// 查看post_max_size配置值
echo "post_max_size: " . ini_get("post_max_size") . "<br/>";
?>
访问这个文件就可以看到当前两个配置项的实际生效值。
修改配置的具体方法
方法一：修改php.ini配置文件
这是最通用也最推荐的方法，找到PHP的配置文件php.ini，不同环境下php.ini的位置可能不同：
- Windows环境一般位于PHP安装目录下。
- Linux环境可以通过php --ini命令查看加载的php.ini路径。
打开php.ini文件，找到以下两个配置项，修改为你需要的大小，比如需要支持上传最大10M的文件，可以设置为：
; 单个上传文件最大大小，设置为10M upload_max_filesize = 10M ; POST请求最大数据大小，需要大于等于upload_max_filesize，设置为12M预留部分空间 post_max_size = 12M
修改完成后需要重启PHP服务或者Web服务器（比如Apache、Nginx）才能让配置生效。
方法二：部分环境使用.htaccess修改
如果使用的是Apache服务器，并且允许在目录下使用.htaccess文件覆盖配置，可以在网站根目录的.htaccess文件中添加以下内容：
php_value upload_max_filesize 10M php_value post_max_size 12M
方法三：使用.user.ini修改
如果服务器开启了user_ini功能，可以在网站根目录创建.user.ini文件，写入以下内容：
upload_max_filesize = 10M post_max_size = 12M
这种方式修改后通常不需要重启服务，等待几秒就会自动生效。
修改后的验证与注意事项
修改完成后，可以再次使用前面的查看配置的PHP文件确认值已经更新。同时需要注意以下几点：
- post_max_size的值一定要大于等于upload_max_filesize的值，否则上传大文件时还是会失败。
- 如果上传的文件还是失败，还需要检查是否有其他限制，比如Web服务器本身的上传大小限制，Nginx需要修改client_max_body_size配置，Apache需要修改LimitRequestBody配置。
- 修改配置后一定要确认服务已经重启或者配置已经生效，否则修改不会起作用。
按照以上步骤修改upload_max_filesize和post_max_size配置后，PHP上传超过2M文件失败的问题就可以得到解决。
PHPupload_max_filesizepost_max_size文件上传修改时间：2026-07-11 06:39:20