PHP 无官方虚拟目录概念，需查Web服务器文档：Apache用Alias指令，Nginx分清alias与root，IIS需手动配置FastCGI映射。

PHP 本身没有官方文档定义“虚拟目录”，因为它不是 PHP 语言或运行时的功能，而是Web 服务器（如 Apache、Nginx、IIS）的 URL 路径映射机制。PHP 只负责执行 .php 文件，不参与路径路由或目录别名管理。

所以，不存在所谓“PHP 官方文档中的虚拟目录配置入口”。你真正需要查的是：

• ✅ Apache 官方文档 → Alias 指令与 <directory></directory> 配置
  入口：https://www.php.cn/link/f3c2509d9994b835f4728d938de2d6d3
  （权威、实时、含 Windows 路径示例和权限说明）

• ✅ Nginx 官方文档 → location + alias / root 行为差异
  入口：https://www.php.cn/link/edcbcd6213372e4d3b5535cd576546e8
  特别注意：alias 会替换匹配前缀，root 是拼接路径——这是 90% 配置失败的根源。

• ✅ Microsoft IIS 官方文档 → 虚拟目录 + FastCGI 处理程序继承
  入口：https://www.php.cn/link/5aa5a75ae84f7b44af308877e69c41d9
  关键点：虚拟目录默认不继承父级 FastCGI 映射，必须手动添加模块映射。

⚠️ 注意：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• phpStudy、宝塔等集成环境屏蔽或接管了底层配置（如 phpStudy v8.1 会自动清空手动写的 Alias），它们的“虚拟目录”实际是子域名站点 + hosts 绑定；
• 所有配置生效前，必须确认：
  • Web 服务器已重启（非重载）；
  • PHP-FPM 或 php-cgi.exe 进程可读目标目录（Windows 下重点检查 IIS_IUSRS 或 SYSTEM 权限）；
  • 路径中无中文、空格、括号，统一用正斜杠 /（如 D:/www/api/）。

不需要翻 PHP.net 手册找“virtual directory”——它根本不在那里。

立即学习“PHP免费学习笔记（深入）”；