PHP8.4Ubuntu系统Nginx搭建PHP虚拟目录-php教程-PHP中文网

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。

php8.4ubuntu系统nginx搭建php虚拟目录

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 版本”无关：

查 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”