PHP 项目中多个子目录入口的 Nginx 配置方式

在 Nginx 中想要实现以子目录方式配置多个 PHP入口 ,似乎并不是什么很难的问题。以 PHP 动态解释方式运行的语言特性,只要像正常项目一样配置,然后把各个入口目录命名组织好就能达成目的。不过我今天碰到的情况有点特殊,为了解决这个问题着实花了点时间。

首先来看看需求。我有三组不同类型,但属于同一个项目下的 URL。它们分别有各自对应的 PHP 文件入口:

  1. 是主域名,它的入口路径为:/app/frontend/public/index.php
  2. /api/v1 是后端接口,它的入口路径为:/app/backend/public/index.php
  3. /file 提供文件服务,它的目录和后端接口相同,但入口文件名不同:/app/backend/public/file.php

从入口地址可以看出,这是一个前后端分离的项目。但根据访问路径,分别指向了不同的 PHP 入口路径。由于访问路径和后台文件目录的不对应,所以采用普通的 Nginx + PHP 配置显然无法达到想要的目的。要解决这个问题,只能先从请求路径入手,一个一个来逐一解决。

首先建立一个常规的 Nginx + PHP 配置,来达成第一个默认路径下的访问请求:

server {
    listen 80;
    server_name www.zzxworld.com;

    # 前端接口
    location / {
        root /app/frontend/public/;
        index index.html index.htm index.php;
        try_files $uri $uri/ /index.php?$query_string;

        location ~ \.php$ {
            fastcgi_pass php82-fpm;
            include fastcgi_params;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        }
    }
}

第二个后端接口的配置稍微有点烧脑,首先来看看配置好的代码,然后再来解释为什么这里会有点复杂。


    # 后端接口
    location /api/v1 {
        rewrite ^/api/v1/(.*)$  /api/$1 break;

        fastcgi_pass php82-fpm;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME /app/backend/public/index.php;
        fastcgi_param REQUEST_URI $document_uri;
    }

上面的配置主要解决了 3 个问题:

  1. 当访问 /api/v1 路径时,需要改写路径,去掉其中的 v1 版本号。这由 rewrite 重写指令来完成。
  2. 指定入口脚本文件的执行路径。这通过 fastcgi_param SCRIPT_FILENAME 配置指令来完成。
  3. 接口功能使用了 Laravel 框架,为了定位到框架中的路由配置。还需要改写 REQUEST_URI 的值。这通过 fastcgi_param REQUEST_URI 来完成。

通过以上三个核心配置,解决了后端接口入口的配置。

最后一个是文件服务入口:

    # 文件接口
    location /file/ {
        alias /app/backend/storage/thumb_files/;
        try_files $uri $uri/ @fileGenerator;
    }

    location @fileGenerator {
        fastcgi_pass php82-fpm;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME /app/backend/public/file.php;
    }

这里通过 alias 指令把 /file/ 请求路径映射到了 /app/backend/storage/thumb_files/ 目录。然后通过 try_files 来判断请求文件在映射的目录中是否存在。如果存在就直接返回文件内容,如果不存在就转发请求到 @fileGenerator 自定义配置区块,交由 /app/backend/public/file.php 来处理请求。根据这个处理流程可以看出,这是一段支持静态缓存的动态文件生成功能配置。

我在后端接口的配置上浪费了一些时间。原以为这是个很简单的问题,网上搜搜就能找到答案。花时间找了一大堆看似有用,实则不行的 Nginx 配置后,决定还是自己来解决。在理顺了需求,并仔细了解了几个 Nginx 配置指令的作用后,终于顺利解决了问题。说到底还是自己对 Nginx 的配置了解不够深入,今天也算是借此机会加深了对一些 Nginx 配置指令的理解。

本文收录于{zzxworld}

© 版权声明

相关文章

暂无评论

暂无评论...