PHP 8.0无虚拟目录功能，需由Web服务器实现跨目录映射；Apache用Alias+ScriptAlias或SetHandler，Nginx用location+alias并正确设置SCRIPT_FILENAME；同时须扩展open_basedir并注意realpath()陷阱。
PHP 8.0 本身不提供“虚拟目录”功能，它只是脚本引擎；所谓虚拟目录是 Web 服务器（Apache/Nginx）的配置行为。跨目录访问（比如把 /api 映射到 /var/www/legacy/api，而主站根目录在 /var/www/v2）的关键，在于绕过文档根目录限制，同时避免 PHP 的 open_basedir 或路径解析错误。
Apache 中用 Alias + ScriptAlias 绕过 DocumentRoot 限制
直接在 httpd.conf 或站点配置中使用 Alias 是最稳妥的方式，但要注意：如果目标路径下有 PHP 脚本，必须额外加 ScriptAlias 或启用 SetHandler，否则 PHP 不会执行。
-
Alias仅做路径映射，不触发 PHP 解析；ScriptAlias才会将匹配路径交由 CGI/模块处理 - 若混用多个 PHP 版本（如主站用 PHP 8.0，虚拟目录用 PHP 7.4），需配合
SetHandler "proxy:fcgi://127.0.0.1:9074"指向对应 FPM socket - 务必在
<Directory>块中显式允许AllowOverride None（禁用 .htaccess）或AllowOverride All（启用），否则 rewrite 规则可能失效
示例配置：
Alias /legacy-api /var/www/legacy/api
<Directory "/var/www/legacy/api">
SetHandler "proxy:fcgi://127.0.0.1:9000"
Require all granted
</Directory>
Nginx 中 location + alias 的路径陷阱
alias 和 root 容易混淆：alias 会**完全替换**匹配路径，root 是拼接路径。跨目录时错用 root 会导致 404 或读取到错误物理路径。
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
- 正确写法：
location /admin { alias /opt/phpadmin/; }→ 请求/admin/index.php对应文件是/opt/phpadmin/index.php - 错误写法：
location /admin { root /opt/phpadmin; }→ 实际找的是/opt/phpadmin/admin/index.php，多了一层 - PHP-FPM 的
SCRIPT_FILENAME必须传真实路径，Nginx 需补全：fastcgi_param SCRIPT_FILENAME $request_filename;（不能用$document_root$fastcgi_script_name，因为$document_root在alias下不生效）
PHP 层面的 open_basedir 与 realpath() 冲突
即使 Web 服务器配置正确，PHP 8.0 默认启用 open_basedir 会拦截跨目录访问。例如 include('/var/www/legacy/config.php') 报错 Warning: include(): open_basedir restriction in effect。
- 检查当前值：
php -i | grep open_basedir，常见值为/var/www/v2:/tmp - 解决方式不是关闭
open_basedir，而是将其扩展为包含目标路径：open_basedir = "/var/www/v2:/var/www/legacy:/tmp" - 注意：
realpath()在符号链接场景下可能返回真实路径，触发open_basedir拦截，此时可改用dirname(__FILE__)或__DIR__避免解析
ThinkPHP 8.0 多应用模式下的“伪虚拟目录”
如果你用的是 ThinkPHP 8.0，且想让 /admin 看似是虚拟目录，实则走 app/admin 应用，别碰 Web 服务器配置——直接用框架路由绑定。
- 确保
config/app.php中'auto_multi_app' => true已开启 - 在
'domain_bind'中写明映射：'admin.example.com' => 'admin'（域名方式）或用子域名规则：'APP_SUB_DOMAIN_DEPLOY' => 1+'APP_SUB_DOMAIN_RULES' => ['admin' => 'admin'] - 关键点：这种方案下，
/admin/xxx请求不会真的去读public/admin/目录，而是由框架统一调度进app/admin，所以不存在跨目录权限问题
真正容易被忽略的是：Web 服务器配置和 PHP 运行时限制（open_basedir、disable_functions）必须同步调整，只改一边必然失败。尤其是 Nginx 的 alias 和 SCRIPT_FILENAME 传参，错一个字符就 502。
