根本原因是虚拟目录未继承或配置PHP处理程序映射，IIS默认不将.php文件识别为可执行脚本；需在虚拟目录节点下手动添加FastCgiModule映射，指向php-cgi.exe，并赋予IIS_IUSRS和IUSR读取执行权限。
PHP 8.0.30 在 Windows + IIS 下创建虚拟目录本身不涉及 PHP 版本逻辑，但配置不当会导致 500、404 或脚本直接下载——根本原因不是“虚拟目录建不建得成”，而是它是否被 IIS 正确识别为可执行上下文，且 PHP 处理程序能穿透到该路径。
为什么虚拟目录里 PHP 文件不执行，只下载或报 500？
这是最常卡住的环节：IIS 默认只对网站根目录（如 C:\inetpub\wwwroot）或显式注册了处理程序的路径执行 php-cgi.exe。虚拟目录只是路径映射，不自动继承父站点的 .php 映射规则。
- 检查 IIS 管理器中该虚拟目录节点下是否有
处理程序映射—— 如果没有，说明它没继承上层配置，PHP 请求不会转发给php-cgi.exe - 右键虚拟目录 → “管理虚拟目录” → “处理程序映射”，看是否已存在名为
PHP_via_FastCGI的条目；若无，需手动添加 - 若已存在，点开编辑，确认“可执行文件”路径是
C:\php\php-cgi.exe（不是php.exe），且“模块”为FastCgiModule - 注意权限：虚拟目录物理路径（如
D:\myapp）必须赋予IIS_IUSRS和IUSR用户“读取 & 执行”权限，否则 FastCGI 进程无法加载 PHP
在 IIS 管理器中给虚拟目录单独加 PHP 处理程序
不能依赖根站点的映射自动下放，必须显式绑定。操作路径比根站点多一步“作用域选择”。
- 在 IIS 管理器左侧树形结构中，**选中你的虚拟目录节点**（例如
Default Web Site/soft），不是根站点 - 双击“处理程序映射” → 右侧“操作”栏点击“添加模块映射”
- 填入：
- 请求路径：
*.php - 模块：
FastCgiModule（必须从下拉菜单选，手输无效） - 可执行文件：
C:\php\php-cgi.exe - 名称：
PHP_via_FastCGI_virtual（建议区别于根目录的命名，避免冲突）
- 请求路径：
- 勾选“仅限脚本”和“验证文件是否存在”
- 点击确定后，刷新页面，该虚拟目录下的
.php就能执行了
php.ini 配置是否影响虚拟目录？
不影响路径映射，但影响所有 PHP 脚本行为——包括虚拟目录里的。尤其注意三个参数在虚拟目录场景下更易暴露问题：
PHP 8.5.12 RC 1
下载
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
-
cgi.fix_pathinfo = 0：不设为0时，IIS 可能错误解析/soft/info.php/xxx这类带尾缀的 URL，导致 500 或空白页 -
doc_root不用设：IIS 不读这个值；PHP 实际工作路径由 IIS 传入的SCRIPT_FILENAME决定，跟虚拟目录物理路径一致 -
open_basedir若启用，必须包含虚拟目录的物理路径（如open_basedir = C:\inetpub\wwwroot;D:\myapp），否则file_get_contents等函数会失败
测试时别只放 info.php 到根目录
很多教程让你把 info.php 放进 C:\inetpub\wwwroot，这只能验证根站点，不能代表虚拟目录生效。
- 在虚拟目录对应物理路径下（如
D:\myapp）新建test.php，内容为：<?php phpinfo(); ?>
- 浏览器访问
http://localhost/soft/test.php（假设别名为soft） - 如果看到 PHP 信息页，且顶部
Loaded Configuration File显示的是C:\php\php.ini，说明链路全通 - 如果报错，打开 IIS 日志（
%SystemDrive%\inetpub\logs\LogFiles\W3SVC1）查sc-status和sc-substatus，比看浏览器提示更准
真正容易被忽略的是：虚拟目录的处理程序映射一旦添加，就独立于父站点；后续修改根站点的 FastCGI 设置（比如改了 php-cgi.exe 路径），不会自动同步过去——每个虚拟目录都是自己的处理程序副本，得挨个更新。
