0

0

PHP怎样调整上传文件限制_PHP调整上传文件限制改动【限制】

雪夜

雪夜

发布时间:2026-01-15 16:27:32

|

140人浏览过

|

来源于php中文网

原创

upload_max_filesize 控制单个文件大小,post_max_size 限制整个 POST 请求体且必须 ≥ 前者,否则 $_FILES 和 $_POST 均为空;还需同步调整 nginx 的 client_max_body_size。

php怎样调整上传文件限制_php调整上传文件限制改动【限制】

php.ini 中 upload_max_filesize 和 post_max_size 的关系

PHP 文件上传限制由两个配置项共同决定:upload_max_filesize 控制单个文件最大体积,post_max_size 控制整个 POST 请求体(含所有字段、文件、边界符)的上限。后者必须 ≥ 前者,否则即使单文件没超限,上传也会失败并静默卡在 $_FILES 为空或 UPLOAD_ERR_NO_FILE

常见错误现象:表单提交后 $_FILES 为空,$_POST 也为空,且无明确报错——大概率是 post_max_size 被触发,导致整个请求体被截断。

  • upload_max_filesize 只影响 $_FILES 中的文件项,不控制其他 POST 字段
  • post_max_size 是硬性闸门:一旦超过,PHP 直接丢弃全部 POST 数据,$_POST$_FILES 都为空
  • 修改后必须重启 Web 服务器(如 Apache 或 PHP-FPM),仅 reload 不生效

如何确认当前生效的限制值

不能只看 php.ini 文件内容,因为运行时可能被 .htaccess、ini_set()、Docker 环境变量或 SAPI 层覆盖。最可靠方式是直接查运行时配置:

注意:ini_get() 返回的是字符串(如 "2M"),不是字节数;若需做数值比较,可用 ini_parse_quantity()(PHP 8.1+)或手动转换(如 return (int)ini_get('upload_max_filesize') * 1024 ** ($unit === 'M' ? 2 : ($unit === 'G' ? 3 : 1)))。

立即学习PHP免费学习笔记(深入)”;

  • CLI 模式下 php -i | grep -E 'upload_max_filesize|post_max_size' 查看 CLI 配置,与 Web 模式无关
  • 使用 phpinfo() 页面时,重点看 “Loaded Configuration File” 路径,并核对 “Master Value” 和 “Local Value” 是否一致
  • 某些共享主机禁用 ini_set() 修改这些选项,强行调用会静默失败

nginx + PHP-FPM 场景下额外要改 client_max_body_size

当 PHP 运行在 nginx 后端时,nginx 本身也会拦截大请求。即使 PHP 层允许 100MB,若 nginx 的 client_max_body_size 仍为默认 1MB,则请求根本到不了 PHP,返回 413 Request Entity Too Large。

酷维CMS企业网站程序1.0
酷维CMS企业网站程序1.0

后台主要功能如下:1) 系统管理:管理员管理,网站配置,上传文件管理,QQ-MSN 在线客服设置。2) 企业信息:后台自由添加修改企业的各类信息及介绍。3) 产品管理:产品类别新增修改管理,产品添加修改以及产品的审核。4) 调查管理:发布修改新调查。5) 会员管理:查看修改删除会员资料,及锁定解锁功能。可在线给会员发信!6) 新闻管理:能分大类和小类新闻,不再受新闻栏目的限制。7) 留言管理:管理

下载

需在 nginx 配置中显式设置(通常在 httpserverlocation 块内):

client_max_body_size 100M;

修改后执行 nginx -t && nginx -s reload 生效。该值应 ≥ post_max_size,否则前端就被拦下了。

  • 如果用 FastCGI,还需检查 fastcgi_buffersfastcgi_buffer_size,极端大文件上传可能触发缓冲区溢出(但一般 100MB 内无需调整)
  • Docker 环境中,若通过环境变量传入 PHP 配置(如 -e PHP_UPLOAD_MAX_FILESIZE=100M),需确认基础镜像是否支持该机制(如 official php:apache 默认不处理)

临时绕过限制的替代方案(不推荐长期使用)

有些场景无法修改服务器配置(如第三方托管、CI 环境测试),可考虑分片上传或前端压缩。但要注意:

  • JavaScript 的 File.slice()stream().pipe() 可切片,但服务端必须自己拼接,PHP 原生不支持“续传”或“分片合并”
  • 前端 ZIP 压缩(如 JSZip)能减小体积,但用户需安装额外库,且压缩/解压消耗 CPU,移动端易卡顿
  • set_time_limit(0) 不能解决上传超时,它只影响脚本执行时间;上传超时由 web server(如 nginx client_header_timeout / client_body_timeout)和 PHP max_input_time 共同控制

真正难调的从来不是改几个数字,而是确认哪一层(nginx → PHP-FPM → php.ini → .htaccess → Docker → 宿主机)实际生效,以及谁在静默丢弃请求。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2533

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1604

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1497

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

952

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1416

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1234

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1445

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1306

2023.11.13

Golang gRPC 服务开发与Protobuf实战
Golang gRPC 服务开发与Protobuf实战

本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

6

2026.01.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.7万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 7万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号