Homestead环境下Nginx按路径切换根目录的API访问异常问题

我来帮你搞定这个Nginx配置的问题！你现在的需求是把独立的API代码库挂载到主站点域名下的/api/v1/路径，但当前配置下访问这个路径会跳转到主站的index.php，咱们先看看问题出在哪，再给你调整配置。

问题分析 #

从你提供的调试日志能看出来关键问题：当请求/api/v1/时，Nginx用root指令把请求路径直接拼到了API的目录后面，变成了/c/Users/Me/Homestead/api/v1/public/api/v1/——这个路径显然不存在，所以触发了try_files的回退规则，去请求/index.php，但这个回退的路径没有正确指向API目录下的index.php，反而被主站点的location /接管了，最终跳转到主站的入口文件。

核心问题是**root指令的行为不符合你的需求**：root是把请求的URI完整附加到指定目录后，而你需要的是把/api/v1/这部分路径替换成API代码库的public目录，这时候应该用alias指令。

修正后的Nginx配置 #

下面是调整后的完整配置，我会标注关键修改点：

server {
    server_name .mydomain.test;
    root "/c/Users/Me/Homestead/site/public";
    index index.html index.php;

    # 处理API路径的location，调整正则和指令
    location ~* ^/api/(v[0-9]+)/(.*)$ {
        # 用alias替换root，将/api/v1/替换为对应版本的API public目录
        alias "/c/Users/Me/Homestead/api/$1/public/$2";
        index index.php;
        # 调整回退路径，确保指向API目录下的index.php
        try_files $uri $uri/ /api/$1/index.php?$query_string;

        # 添加PHP FastCGI配置，确保API的PHP文件能被正确解析
        location ~ \.php$ {
            fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 根据你的PHP版本调整路径
            fastcgi_index index.php;
            fastcgi_param SCRIPT_FILENAME $request_filename;
            include fastcgi_params;
        }

        error_log /var/log/nginx/mydomain.test-error.log debug;
    }

    location / {
        try_files $uri $uri/ /index.php?$query_string;
        error_log /var/log/nginx/mydomain.test-error.log debug;

        # 主站点的PHP解析配置
        location ~ \.php$ {
            fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
            fastcgi_index index.php;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            include fastcgi_params;
        }
    }
}

关键修改说明 #

• 正则调整：把location ~* /api/(v[0-9]+)/改成^/api/(v[0-9]+)/(.*)$，这样能同时捕获API版本号（比如v1）和后续的请求路径（比如users），方便alias精准映射。
• 替换root为alias：alias会把匹配到的/api/v1/部分替换成指定的API目录，比如请求/api/v1/users会直接映射到/c/Users/Me/Homestead/api/v1/public/users，完美匹配你的API代码结构。
• 调整try_files回退路径：当请求的文件/目录不存在时，会回退到/api/$1/index.php，也就是对应版本API的入口文件，而不是主站的index.php。
• 补充PHP FastCGI配置：原配置缺少PHP解析的关键配置，导致即使找到API目录下的index.php也无法正确执行，补充后确保API的PHP代码能被Nginx正确转发给PHP-FPM处理。

修改完配置后，重启Nginx，再访问mydomain.test/api/v1/应该就能正常指向你的独立API代码库了！

内容的提问来源于stack exchange，提问作者Chris Starling