重置虚拟目录PHP解析模块必须修改其web.config文件，不能仅依赖IIS管理器配置；因虚拟目录一旦存在web.config即完全接管处理器映射，需确保<system.webServer><handlers>下仅有一条*.php的add规则且scriptProcessor精确指向目标PHP 8.4.x的php-cgi.exe路径，并同步校准php.ini中fastcgi.impersonate=1与cgi.fix_pathinfo=0。
重置虚拟目录的 PHP 解析模块必须改 web.config，不能只动 IIS 管理器
虚拟目录（Virtual Directory）在 IIS 中默认继承父站点的处理器映射，但一旦你手动为它配置了 web.config，所有解析行为就由该文件完全控制——IIS 管理器里对父站点做的修改（比如删掉或新增 handler）不会自动同步进来。
常见错误现象是：改完父站点的 FastCGI 映射后，虚拟目录仍报 500 错误或直接下载 .php 文件，原因就是它的 web.config 还保留着旧的 <handlers> 配置，甚至可能指向已删除的 PHP 版本路径。
- 打开虚拟目录根目录，确认是否存在
web.config；若存在，必须编辑它，而不是只在 IIS 管理器里点“重新映射” -
<system.webServer> → <handlers>下只能有一条匹配*.php的<add>，且scriptProcessor必须精确指向目标 PHP 8.4.x 的php-cgi.exe路径（例如C:\php\php-8.4.1\php-cgi.exe） - 若该
web.config是从其他站点复制来的，务必检查并清除重复的<remove name="PHP_via_FastCGI" />或冲突 handler，否则 IIS 加载失败 - 修改后无需重启 IIS，但需确保 IIS_IUSRS 对该
web.config有读取权限，否则返回 500.19 错误
fastcgi.impersonate=1 和 cgi.fix_pathinfo=0 缺一不可
PHP 8.4 在 IIS 下运行时，这两个 php.ini 设置不是可选项，而是硬性要求。漏设任意一个，都可能导致 500 错误、空白页或 open_basedir 拒绝访问等隐蔽问题。
-
fastcgi.impersonate = 1：让 PHP 进程以当前请求用户（通常是IUSR）身份执行文件操作；不启用会导致fopen()、file_get_contents()等函数因权限不足失败 -
cgi.fix_pathinfo = 0：关闭路径信息解析，防止恶意构造/index.php/xxx.jpg绕过脚本限制；PHP 8.4 默认为 1，必须显式设为 0，否则 IIS 可能返回 404 或执行错误文件 - 两个设置必须写在各自 PHP 版本的
php.ini里（通过PHPRC环境变量指定），不能靠全局配置覆盖
用 appcmd 批量重置比图形界面更可靠
当多个虚拟目录需要统一重置 PHP 解析模块时，IIS 管理器逐个右键操作容易遗漏或错配。用 appcmd 命令行可精准定位到具体虚拟目录，避免继承污染。
立即学习“PHP免费学习笔记（深入）”；
例如，重置名为 myapp 的虚拟目录（属于 Default Web Site）的 PHP handler：
appcmd set config "Default Web Site/myapp" -section:system.webServer/handlers /-[name='PHP841'] appcmd set config "Default Web Site/myapp" -section:system.webServer/handlers /+[name='PHP841',path='*.php',verb='*',modules='FastCgiModule',scriptProcessor='C:\php\php-8.4.1\php-cgi.exe',resourceType='Unspecified']
- 第一行先移除旧 handler（名称必须与现有配置一致，可通过
appcmd list config "Default Web Site/myapp" -section:handlers查看） - 第二行添加新 handler，
scriptProcessor路径必须用绝对路径，且不能包含引号 - 命令执行后立即生效，无需重启，但需确认对应 PHP 版本的 FastCGI 条目已在服务器级
FastCGI Settings中注册并启用
PHP 8.4.1 和 8.4.3 共存时，虚拟目录不能共享 FastCGI 应用
即使两个 PHP 版本都在同一台机器上，每个虚拟目录也必须绑定到其专属的 FastCGI 应用条目。共用同一个 php-cgi.exe 路径（哪怕只是符号链接或快捷方式）会导致进程混用、phpinfo() 显示版本错乱、扩展加载冲突。
- 检查方法：在虚拟目录下放一个
info.php，访问后看PHP Version和Loaded Configuration File是否与预期一致 - 若显示版本正确但扩展缺失，大概率是
extension_dir指向了另一个版本的ext目录，需核对各自php.ini中的extension_dir = "C:\php\php-8.4.x\ext" - 最易忽略的一点：IIS 的 FastCGI 设置里，每个条目的
PHPRC环境变量值必须和该虚拟目录实际使用的php.ini路径完全一致，尾部反斜杠不能少也不能多（C:\php\php-8.4.1\✅，C:\php\php-8.4.1❌）
