PHP本身不创建虚拟目录，而是Web服务器（IIS/Apache）配置任务；常见问题为PHP脚本无法执行、被下载、空白或500错误，根源在于服务器未将.php请求正确交由PHP解析器处理：IIS需手动为虚拟目录添加FastCgiModule映射，Apache需在块中显式配置AddHandler并确保AllowOverride非None，同时校验权限、SCRIPT_FILENAME路径拼接、php.ini设置及open_basedir白名单。
PHP 本身不创建虚拟目录——那是 Web 服务器（IIS 或 Apache）的配置任务。所谓“PHP 创建虚拟目录报错”，实际是配置虚拟目录后，PHP 脚本无法执行、下载、空白或 500 报错。核心问题不在 PHP 代码，而在服务器能否把 .php 请求正确交给 PHP 解析器。
一、IIS 下虚拟目录 PHP 不执行：检查处理程序映射
新建的虚拟目录默认不继承父网站的 .php 映射规则，这是最常见原因。
- 在 IIS 管理器中选中该虚拟目录 → 双击「处理程序映射」→ 查看列表里是否有
PHP_via_FastCGI类条目 - 没有就手动添加：点击右侧「添加模块映射…」→ 填写：
• 请求路径：*.php
• 模块：FastCgiModule（必须从下拉菜单选）
• 可执行文件：C:phpphp-cgi.exe（路径需与你安装一致）
• 名称：如PHP_via_FastCGI_in_vdir（避免重名） - 更稳妥的做法：右键虚拟目录 → 「转换为应用程序」→ 应用程序池保持默认，但确认其「启用 32 位应用」和「.NET CLR 版本 = 无托管代码」
二、Apache 下虚拟目录 PHP 文件被下载或空白：确认 AddHandler 生效
Apache 的 AddHandler application/x-httpd-php .php 默认只在全局或虚拟主机级生效，可能被虚拟目录的 <directory></directory> 配置屏蔽。
- 检查虚拟目录对应
<directory></directory>块中是否含AllowOverride None—— 若有，改为AllowOverride FileInfo或All - 在该
<directory></directory>块内显式添加：AddHandler application/x-httpd-php .php - 确认模块已启用：
apache2ctl -t -D DUMP_MODULES | grep php输出应含php8_module - 若用 FPM 模式，不能依赖
AddHandler，而需配ProxyPassMatch并确保proxy_fcgi模块已加载
三、No input file specified 或 404：SCRIPT_FILENAME 路径拼接失败
虚拟目录常通过 Alias 指向非 DocumentRoot 下的路径，导致 PHP 收不到正确的脚本绝对路径。
立即学习“PHP免费学习笔记（深入）”；
- Apache 中，
Alias /vdir "/data/app"后，必须配匹配的<directory></directory>块，并含：Require all grantedOptions +ExecCGI - IIS 中，ThinkPHP/Laravel 等框架需额外在虚拟目录根放
Web.config，补全重写规则，把/vdir/index.php/abc正确转为/vdir/index.php?/abc - 物理路径务必全英文、无空格、无中文；Windows 下路径分隔符用正斜杠
/或双反斜杠\
四、权限与 PHP 配置类静默失败
即使映射正确，仍可能因底层限制导致 PHP 文件执行卡住或创建失败。
- PHP 进程用户（IIS 是
IIS_IUSRS，Apache 是www-data或apache）必须对虚拟目录物理路径有读+执行（rx）权限 - 检查
php.ini：
•fastcgi.impersonate = 1（IIS 必开）
•cgi.fix_pathinfo = 1（IIS 推荐）
•extension_dir = "C:/php/ext"（正斜杠或双反斜杠） - 排查
open_basedir：运行echo ini_get('open_basedir');，若返回非空，需将虚拟目录物理路径加入白名单 - 用
error_get_last()捕获真实系统错误，比单纯看返回值更可靠
