PHP 8.2 本身不处理虚拟目录，由 Web 服务器（Apache 或 Nginx）配置实现：Apache 用 Alias + SetHandler 指向 php8.2-fpm，Nginx 用 location + alias 并正确设置 SCRIPT_FILENAME $request_filename，关键需确保 PHP-FPM 运行、权限匹配及 socket 路径正确。
PHP 8.2 本身不处理虚拟目录——它只是解释器。真正决定「/admin」是否映射到 /var/www/backend 的，是 Web 服务器（Apache 或 Nginx）的配置。你用的是哪个？下面分场景说明。
Apache 中用 Alias 配置 PHP8.2 项目的虚拟目录
适合在单个域名下挂多个子路径项目，比如 http://localhost/cms、http://localhost/api，各自指向不同物理目录。
关键点不是 PHP 版本，而是 Apache 必须能正确把请求交给 php8.2-fpm 或 libapache2-mod-php8.2 处理。常见错误是只配了 Alias，却没给新路径开 PHP 执行权限。
- 在
httpd.conf或站点配置中添加：
<Alias /cms "/var/www/my-cms">
<Directory "/var/www/my-cms">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
<FilesMatch \.php$>
SetHandler "proxy:unix:/run/php/php8.2-fpm.sock|fcgi://localhost"
</FilesMatch>
</Directory>
-
SetHandler这一行不能少：它告诉 Apache，所有.php文件必须走php8.2-fpm；如果用模块方式（libapache2-mod-php8.2），改用AddType application/x-httpd-php .php - 确保
mod_alias和mod_proxy_fcgi已启用：a2enmod alias proxy_fcgi - 重启后访问
http://localhost/cms/index.php，若报 500 且日志里有Failed to connect to Unix domain socket，说明php8.2-fpm.sock路径不对，查systemctl status php8.2-fpm输出里的listen =行
Nginx 中用 location + alias 挂载 PHP8.2 子项目
和 Apache 的 Alias 类似，但 Nginx 的 alias 和 root 容易混淆——alias 是「替换路径前缀」，root 是「拼接路径」。配错直接 404。
- 示例：让
/blog指向/var/www/wordpress
location /blog {
alias /var/www/wordpress/;
index index.php;
location ~ \.php$ {
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_param SCRIPT_FILENAME $request_filename;
include fastcgi_params;
}
}
- 注意结尾斜杠：
alias值末尾必须有/，否则/blog/index.php会去找/var/www/wordpressindex.php（少了个斜杠） -
SCRIPT_FILENAME $request_filename是关键：它把/blog/index.php映射成真实路径，而不是依赖root拼接 - 如果项目含重写（如 WordPress 的 permalink），需额外加
try_files $uri $uri/ /blog/index.php?$args;在location /blog块内
为什么 PHP8.2 项目跑不起来？先盯这三个地方
多数“配置完了但白屏/500”的问题，跟 PHP 版本无关，而是 Web 服务器和 PHP-FPM 协作链断了。
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
-
php8.2-fpm进程是否在运行？systemctl is-active php8.2-fpm必须返回active - PHP-FPM pool 配置里
listen.owner和listen.group是否匹配 Web 服务器用户（www-data或nginx）？权限不对就连接不上 socket - Apache 的
Require all granted或 Nginx 的allow all缺失，会导致 403；而AllowOverride None会禁掉.htaccess重写，影响 Laravel/ThinkPHP 等框架
别用 .htaccess 做虚拟目录（尤其生产环境）
虽然 .htaccess 可以用 RewriteRule 伪造路径，但它每次请求都要读取解析，性能差，且 Apache 默认可能禁用 AllowOverride。更麻烦的是：它无法改变 DocumentRoot，所以 __DIR__、require_once 路径容易错乱，PHP8.2 的严格类型检查会让这类路径错误立刻暴露为致命错误。
真正要隔离多项目，优先走 Web 服务器原生的 VirtualHost（多域名）或 Alias/location（多路径），而不是靠重写欺骗 PHP。
