必须同时调整upload_max_filesize和post_max_size,仅改其一将导致post请求被静默截断、$_files为空;需确认真实php.ini路径,设upload_max_filesize=128m、post_max_size=132m、memory_limit≥256m、max_execution_time=max_input_time≥300,并重启php-fpm或web服务器。

要让PHP环境支持更大的文件上传,必须同时调整upload_max_filesize和post_max_size两个参数,只改其中一个会导致上传失败——比如单个文件明明没超限,但整个POST请求因总量超标被直接截断,$_FILES为空且无标准错误码。
确认当前生效的php.ini路径
创建一个名为info.php的文件,内容为,用浏览器访问它,在页面中搜索“Loaded Configuration File”,记下该路径。这一步不能跳过,XAMPP、Docker、宝塔、系统自带PHP可能各自加载不同ini文件。
【务必确认此处显示的路径才是你要编辑的真实配置文件】
命令行也可快速验证:执行php --ini,输出中的“Loaded Configuration File”行与phpinfo()一致。
修改upload_max_filesize与post_max_size
用文本编辑器打开上一步确认的php.ini文件。
搜索upload_max_filesize,将其值改为所需大小,例如:upload_max_filesize = 128M。
接着搜索post_max_size,将其设为≥ upload_max_filesize的值,例如:post_max_size = 132M。注意:post_max_size必须覆盖所有POST数据总和,包括文件、表单字段、边界分隔符,所以建议比upload_max_filesize多出4~8MB缓冲空间。
数值后必须带单位(M或G),写成128是无效的;单位不区分大小写,但不要写成128MB(部分PHP旧版本会解析失败)。
同步检查memory_limit与超时设置
找到memory_limit配置项,将其设为post_max_size的1.5~2倍,例如post_max_size = 132M时,memory_limit至少设为256M。PHP处理大文件上传时需将整个POST体载入内存,若memory_limit不足,脚本会在解析阶段崩溃,错误日志里出现“Allowed memory size exhausted”。
查找max_execution_time和max_input_time,将二者都设为300或更高(单位:秒)。上传大文件耗时长,若超时触发,PHP会中断接收,导致文件残缺或$_FILES为空。
max_file_uploads可按需调整,默认20,表示单次请求最多上传20个文件;若业务需批量上传更多小文件,可适当调高。
重启服务使配置生效
第一步:保存php.ini文件。
第二步:根据你的Web服务器类型执行对应操作:
→ Apache环境:sudo systemctl restart apache2(Ubuntu/Debian)或sudo apachectl graceful(macOS)
→ Nginx + PHP-FPM环境:sudo systemctl restart php*-fpm(如php8.2-fpm)→ 再执行sudo systemctl restart nginx
→ Docker容器内:需重建容器或进入容器执行service php*-fpm restart(取决于镜像设计)
重启后,再次访问info.php,确认upload_max_filesize和post_max_size的值已更新,且“Local Value”与“Master Value”一致。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











