phpStudy2018Nginx环境添加PHP虚拟目录-php教程-PHP中文网

nginx不支持.htaccess和alias指令，因其无运行时解析机制，php执行依赖fastcgi_pass与显式location匹配，且script_filename必须由$request_filename正确赋值以适配alias路径映射。

phpstudy2018nginx环境添加php虚拟目录

phpStudy2018 的 Nginx 模式下不支持 Apache 风格的 .htaccess 或 Alias 虚拟目录语法，必须通过修改 vhosts.conf 中的 server 块来实现类似效果——本质是新增一个独立 location 规则，指向非根目录的 PHP 脚本路径。

为什么不能直接用 Apache 的 Alias / AddType 方式

Nginx 没有 Alias 指令，也不在运行时解析 .htaccess。它的 PHP 支持依赖 fastcgi_pass + 显式 location ~ \.php 匹配，且 SCRIPT_FILENAME 必须由 $document_root 拼接得出。若想让 /api/ 下的 PHP 文件可执行，就得单独定义该路径的 fastcgi 处理逻辑，否则会 404 或直接下载源码。

添加 PHP 虚拟目录的正确写法（以 /admin-api 为例）

在 vhosts.conf 对应 server 块内追加以下内容：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

location ^~ /admin-api/ {
    alias "D:/phpStudy/PHPTutorial/WWW/myproject/api/";
    index index.php;
    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $request_filename;
        include fastcgi_params;
    }
}

alias 后路径末尾必须带斜杠，且需与 location 路径结尾一致，否则文件映射错位
SCRIPT_FILENAME $request_filename 是关键：用 $request_filename 替代 $document_root$fastcgi_script_name，避免因 alias 导致根目录拼接错误
^~ 修饰符确保该规则优先于正则匹配，防止被通用 location ~ \.php 覆盖
不要在 alias 路径里混用 root，二者互斥；root 是相对 server 根，alias 是绝对映射

常见错误现象和对应修复

访问 /admin-api/test.php 时返回 404 或 502：

现象：File not found.（Nginx error log）→ 检查 alias 路径是否真实存在、权限是否允许 Nginx 进程读取（Windows 下注意 SYSTEM 用户权限）
现象：浏览器下载 test.php 源码 → location ~ \.php$ 未生效，确认它嵌套在 /admin-api/ 的 location 内，且未被外层 location ~ \.php 提前截断
现象：PHP 报错 Undefined variable $_SERVER['DOCUMENT_ROOT'] → 因用了 $request_filename，部分框架依赖 $_SERVER 变量，需手动补全：fastcgi_param DOCUMENT_ROOT $realpath_root;