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.web>两个节 - 在
<system.webServer> <security> <requestFiltering>下设置：<requestLimits maxAllowedContentLength="524288000" />
（单位是字节；524288000 = 500MB，按需调整，最大支持约 2GB） - 在
<system.web>下设置：<httpRuntime maxRequestLength="512000" executionTimeout="600" />
（maxRequestLength单位是 KB；512000 KB = 500MB；executionTimeout建议同步加大，避免超时中断）
PHP 层：修改 php.ini 并确认生效路径
仅改 IIS 不够，PHP 运行时仍会按自身规则校验。找到 PHP 7.4.33 实际加载的 php.ini（不是安装包里的模板，而是 IIS 调用的那个）：
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
- 新建一个
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 对应的路径 → 右键「重新激活」或「刷新」
验证是否真正生效
改完别急着上传大文件，先快速验证两层是否都已更新：
立即学习“PHP免费学习笔记（深入）”；
- 刷新
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>根节点完整，XML 标签闭合，且文件编码为 UTF-8 无 BOM - 没刷新 FastCGI 缓存：改完 php.ini 后只重启 IIS 是无效的，必须在 IIS 管理器中对 PHP 实例执行「重新激活」
-
临时目录无写入权限：检查
upload_tmp_dir指向的路径（如C:\Windows\Temp），IIS_IUSRS 用户需有写权限
