基于URL首个分段动态设置Nginx root的实现问题

针对你的问题，直接给出解决方案和关键修改点：

1. 必须基于URL首个分段动态设置root #

每个子应用对应独立的目录，必须将请求定位到对应子目录作为根目录，否则无法加载子应用的index.php和静态资源。

2. 需要调整try_files逻辑 #

原配置的try_files会将未找到的资源转发到根目录的index.php，现在需要修改为转发到对应子目录的index.php，同时优先检查子目录内的静态文件。

3. 必须修改fastcgi参数 #

需要动态拼接子目录路径到SCRIPT_FILENAME，确保PHP-FPM能找到正确的子应用index.php；同时调整SCRIPT_NAME和相关参数，保证Slim框架能正确解析路由。

完整Nginx配置示例 #

server {
    listen 80;
    listen [::]:80;
    
    server_name app.project.test;
    
    absolute_redirect off;
    index index.php;

    # 处理根路径访问（可选，根据需求调整，比如返回404或跳转）
    location = / {
        return 404;
    }

    # 匹配子应用路径：捕获URL首个分段作为子目录名称
    location ~ ^/([^/]+)/ {
        set $app_dir $1;
        root /var/www/project/instances/$app_dir;

        # 优先检查子目录内的静态文件，不存在则转发到子目录的index.php
        try_files $uri $uri/ /$app_dir/index.php$is_args$args;

        location ~ \.php$ {
            fastcgi_pass 127.0.0.1:9000;
            try_files $uri =404;
            fastcgi_split_path_info ^(.+\.php)(/.+)$;
            include fastcgi_params;

            # 动态设置脚本路径：子目录root + 脚本名称
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            # 传递正确的脚本名称给Slim，确保路由解析正常
            fastcgi_param SCRIPT_NAME /$app_dir$fastcgi_script_name;
            # 传递完整的请求URI，Slim需要这个来解析路由
            fastcgi_param REQUEST_URI $request_uri;
            fastcgi_index index.php;
        }
    }

    # 处理子应用根路径（比如app.project.test/1直接访问的情况）
    location ~ ^/([^/]+)$ {
        return 301 /$1/;
    }
}

关键配置说明 #

• 动态root：通过^/([^/]+)/捕获URL第一个分段作为$app_dir，将root设置为对应子目录路径，确保所有静态资源和脚本都从该目录加载。
• try_files调整：try_files $uri $uri/ /$app_dir/index.php$is_args$args先检查当前请求的静态文件，不存在则转发到子应用的index.php，避免错误转发到根目录脚本。
• fastcgi参数修改：
  • SCRIPT_FILENAME：结合动态root和脚本名称，让PHP-FPM能找到正确的子应用index.php。
  • SCRIPT_NAME：包含子目录前缀，确保Slim框架能正确识别路由的基础路径，避免路由解析错误。
  • REQUEST_URI：传递完整请求URI，保证Slim能正确解析子应用内的路由规则。

内容的提问来源于stack exchange，提问作者Oliver Maksimovic