PHP 8.4已于2026年1月3日正式发布，但截至2026年10月，实际部署中需确认真实版本（如8.3.14），Ubuntu+Nginx下虚拟目录配置关键在alias路径、fastcgi_param SCRIPT_FILENAME使用$request_filename、php-fpm socket权限对齐及cgi.fix_pathinfo=0。
PHP 8.4 不存在——截至 2026 年 10 月，PHP 官方最新稳定版是 8.3.14（或相近小版本），8.4 的正式发布日期是 **2026 年 1 月 3 日**，但那只是计划时间点；目前所有标称“PHP 8.4”的安装源、Docker 镜像、PPA 包名（如 php84、php-8.4）均为非官方命名、测试分支或误标。你实际要配的，几乎肯定是 PHP 8.3。
下面直奔 Ubuntu + Nginx 下 PHP 虚拟目录（即子路径下运行独立 PHP 应用，如 https://example.com/app1/）的实操要点。
确认真实 PHP 版本并安装对应 php-fpm
别信包名，只信输出：
- 运行
php -v，看完整版本号，例如PHP 8.3.12 (fpm-fcgi) - 检查
phpinfo()页面里的PHP Version行 - Ubuntu/Debian 上，正确安装命令是：
sudo apt install php8.3-fpm php8.3-cli php8.3-mysql php8.3-curl（不是php84） - 装完后必须启用服务：
sudo systemctl enable php8.3-fpm && sudo systemctl start php8.3-fpm
Nginx location 块必须匹配虚拟目录路径
虚拟目录 ≠ 虚拟主机，它是在同一域名下划分路径（如 /admin/、/api/）。关键在 location 的正则和 root/alias 选择：
- 用
alias处理子路径映射（推荐）：location /app1/ { alias /var/www/app1/; index index.php; }
注意结尾斜杠：/app1/对应/var/www/app1/，且alias路径末尾必须带/ - 用
root也可，但需手动拼接：location /app1/ { root /var/www; index index.php; }
此时请求/app1/index.php会查找/var/www/app1/index.php—— 逻辑更直观，但易漏掉层级 - PHP 解析必须单独配一个嵌套
location ~ \.php$，且fastcgi_param SCRIPT_FILENAME必须用$request_filename或完整拼接，不能只靠$document_root$fastcgi_script_name（否则路径错位）
示例（安全写法）：
PHP 8.5.12 RC 1
下载
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
location /app1/ {
alias /var/www/app1/;
index index.php;
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
fastcgi_param SCRIPT_FILENAME $request_filename;
}
}
php-fpm pool 权限与 socket 路径必须对齐
502 错误八成卡在这儿，和“PHP 版本”无关：
立即学习“PHP免费学习笔记（深入）”；
- 查 socket 文件是否存在：
ls -l /run/php/php8.3-fpm.sock（Ubuntu 默认路径） - 确认该 socket 属主是 php-fpm pool 配置里指定的用户，比如
www-data：
检查/etc/php/8.3/fpm/pool.d/www.conf中的listen.owner和listen.group - Nginx worker 进程用户（
/etc/nginx/nginx.conf中的user指令）必须能读写该 socket，通常也设为www-data - 如果改过
listen路径（如改成/var/run/php/app1.sock），fastcgi_pass必须同步更新，且确保目录存在、权限放开
常见陷阱：cgi.fix_pathinfo 和 PATH_INFO 伪造
这是最隐蔽的安全与功能双坑：
- 默认
cgi.fix_pathinfo=1（在/etc/php/8.3/fpm/php.ini）允许 Nginx 把/app1/xxx.jpg/test.php这类路径“降级解析”成 PHP 执行，既危险又导致$_SERVER['PATH_INFO']错乱 - 必须设为
cgi.fix_pathinfo=0，然后靠 Nginx 显式拆分：fastcgi_split_path_info ^(.+\.php)(/.+)$;fastcgi_param PATH_INFO $fastcgi_path_info; - 否则 Laravel、ThinkPHP 等框架的路由会失效，或出现 404 / “No input file specified”
php8.3-fpm.sock 文件权限不对、alias 少了个斜杠、SCRIPT_FILENAME 拼错了路径、或者 cgi.fix_pathinfo 还开着——这些地方一错，Nginx 只报 502 或 404，日志里却没直接线索。 
