Nginx 不支持 Apache 的 Alias 指令，虚拟目录需用 location + alias 或 rewrite 实现；alias 严格替换路径段且依赖末尾斜杠、绝对路径及权限对齐，配置错误易致404或PHP被下载；PHP 8.3.28 已进入维护期末期（2026年9月最后更新），不建议新项目使用，其禁用 mysql_connect()、强化 mbstring strict mode，并要求非 ZTS 版本与 Nginx+PHP-FPM 兼容，opcache.revalidate_freq 设为 0 可提升开发时效性。
PHP 8.3.28 在 Nginx 下不能直接“创建虚拟目录”——Nginx 本身没有 Apache 的 Alias 指令，所谓虚拟目录必须靠 location + alias 或 rewrite 实现，且极易因路径解析错误导致 404 或 PHP 文件被下载。尤其 PHP 8.3.28 已进入维护期（2026 年 10 月），不建议用于新项目，但若必须用，关键在 Nginx 配置细节和权限对齐。
为什么 Nginx 的 alias 容易 404
Nginx 的 alias 不是前缀映射，而是**完全替换路径段**，且末尾斜杠必须严格匹配。常见错误：
-
location /api { alias /var/www/v1/; }→ 请求/api/test.php会找/var/www/v1/test.php（正确） -
location /api { alias /var/www/v1; }（缺末尾斜杠）→ 请求/api/test.php会找/var/www/v1test.php（拼接错误，404） -
alias后路径**不能用变量或相对路径**，必须是绝对路径，且 Nginx worker 进程用户（如www-data或nginx）需有读取权限
location + alias 配 PHP 虚拟目录的写法
假设你要把 /admin 映射到 /opt/php-admin，且该目录下有 index.php：
location /admin {
alias /opt/php-admin/;
index index.php;
<pre class="brush:php;toolbar:false;"># 必须显式处理 PHP 文件
location ~ \.php$ {
# 注意：alias 下的 $fastcgi_script_name 是 /admin/xxx.php，要重写为真实路径
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_param SCRIPT_FILENAME $request_filename;
fastcgi_param PATH_INFO $fastcgi_path_info;
include fastcgi_params;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}}
立即学习“PHP免费学习笔记（深入）”；
重点：
-
$request_filename是 Nginx 拼出的完整磁盘路径（由alias和 URI 共同决定），比$document_root$fastcgi_script_name更可靠 - 不要用
root替代alias，否则/admin/index.php会被解析成/opt/php-admin/admin/index.php（多了一级） - PHP 8.3.28 默认禁用短标签，确保
/opt/php-admin下的php.ini中short_open_tag = Off（除非你明确需要）
替代方案：用 rewrite + root 更安全
如果只是想让某个 URL 前缀指向另一个物理目录，且该目录结构独立（比如就是个普通 PHP 应用），用 rewrite 更直观、容错性更高：
location ^~ /admin {
rewrite ^/admin/(.*)$ /admin-root/$1 last;
}
<p>location /admin-root {
alias /opt/php-admin/;
index index.php;</p><pre class="brush:php;toolbar:false;">location ~ \.php$ {
fastcgi_param SCRIPT_FILENAME $request_filename;
include fastcgi_params;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}}
立即学习“PHP免费学习笔记（深入）”；
这样做的好处：
- 避免
alias对斜杠的敏感问题 -
/admin-root是内部路径，不暴露给用户，便于调试 - 所有请求先被 rewrite 到统一前缀，再由
alias处理，逻辑更清晰
PHP 8.3.28 的实际兼容风险
PHP 8.3.28 是 8.3 系列的最后一个安全更新版（2026 年 9 月发布），但已明确不支持以下常见操作：
-
mysql_connect()等已被彻底移除（不是弃用），必须用mysqli或PDO -
mbstring扩展默认启用 strict mode，mb_detect_encoding('', 'auto')可能返回false而非猜测结果 - 若虚拟目录下有旧框架（如 Laravel 9 以下、ThinkPHP 5.x），路由中间件可能因
__invoke参数反射变化而报ArgumentCountError - 检查
php -v输出是否含ZTS（线程安全），Nginx + PHP-FPM 场景必须用非 ZTS 版本，否则opcache无法共享
最常被忽略的一点：Nginx 配置 reload 后，PHP-FPM 的 opcache.revalidate_freq 默认是 2，意味着即使你改了 PHP 文件，最多要等 2 秒才生效——开发时建议设为 0，上线再调回。
