php上传失败需同步调整iis与php双层配置:iis层在web.config中设maxallowedcontentlength(字节)和maxrequestlength(kb),php层在php.ini中调大upload_max_filesize、post_max_size等参数,并重启fastcgi进程验证生效。

Windows IIS10 上运行 PHP 7.4.33 时,文件上传失败(如提示“超过最大请求长度”或上传后 $_FILES 为空),往往不是 PHP 单方面限制的问题,而是IIS 和 PHP 双层拦截共同作用的结果。必须同步调整两处配置,缺一不可。
IIS 层:修改 web.config 中的请求长度限制
IIS 自身会对 HTTP 请求体做硬性截断,哪怕 PHP 允许传 500MB,IIS 默认只放行 30MB(约 30,000,000 字节)以内内容。需在网站根目录的 web.config 文件中添加或修改以下配置:
- 打开或新建
web.config,确保包含<system.webserver></system.webserver>和<system.web></system.web>两个节 - 在
<system.webserver><security><requestfiltering></requestfiltering></security></system.webserver>下设置:<requestlimits maxallowedcontentlength="524288000"></requestlimits>
(单位是字节;524288000 = 500MB,按需调整,最大支持约 2GB) - 在
<system.web></system.web>下设置:<httpruntime maxrequestlength="512000" executiontimeout="600"></httpruntime>
(maxRequestLength单位是 KB;512000 KB = 500MB;executionTimeout建议同步加大,避免超时中断)
PHP 层:修改 php.ini 并确认生效路径
仅改 IIS 不够,PHP 运行时仍会按自身规则校验。找到 PHP 7.4.33 实际加载的 php.ini(不是安装包里的模板,而是 IIS 调用的那个):
- 新建一个
info.php,内容为<?php phpinfo(); ?>,通过浏览器访问,查找 Loaded Configuration File 对应的路径 - 编辑该
php.ini,修改以下几项(注意单位用 M,不加引号):file_uploads = Onupload_max_filesize = 500Mpost_max_size = 512M(必须 ≥ upload_max_filesize)memory_limit = 512M(建议 ≥ post_max_size,尤其涉及图像处理等)max_execution_time = 600max_input_time = 600 - 保存后无需重启 IIS 服务,但需重启 PHP 进程**:IIS 中打开「FastCGI 设置」→ 找到 PHP 7.4.33 对应的路径 → 右键「重新激活」或「刷新」
验证是否真正生效
改完别急着上传大文件,先快速验证两层是否都已更新:
- 刷新
info.php页面,搜索upload_max_filesize、post_max_size,确认显示值是你设的(如 500M) - 检查
web.config是否被 IIS 正确读取:在 IIS 管理器中选中站点 → 双击「配置编辑器」→ 左侧树形菜单依次展开system.webServer → security → requestFiltering → requestLimits,看maxAllowedContentLength是否匹配 - 上传一个略大于原限制(如原为 2MB,传 3MB)的文件,观察
$_FILES['xxx']['error']:
值为 1 → PHP 的upload_max_filesize拦截
值为 4 → 没选文件
值为 0 → 成功通过两层校验
常见踩坑点
很多问题其实卡在细节上:
-
php.ini 改错文件:IIS + FastCGI 场景下,CLI 和 Web 使用的 php.ini 往往不同,务必以
phpinfo()显示的路径为准 -
web.config 权限或格式错误:确保
<configuration></configuration>根节点完整,XML 标签闭合,且文件编码为 UTF-8 无 BOM - 没刷新 FastCGI 缓存:改完 php.ini 后只重启 IIS 是无效的,必须在 IIS 管理器中对 PHP 实例执行「重新激活」
-
临时目录无写入权限:检查
upload_tmp_dir指向的路径(如C:\Windows\Temp),IIS_IUSRS 用户需有写权限
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











