使用 Nginx、FPM 和 Laravel 实现特定 URL 路由-php教程-PHP中文网

使用 Nginx、FPM 和 Laravel 实现特定 URL 路由

DDD

发布： 2025-09-30 17:14:01

原创

657人浏览过

使用 nginx、fpm 和 laravel 实现特定 url 路由

本文旨在解决在使用 Nginx 作为反向代理，并结合 PHP-FPM 运行 Laravel 应用时，如何将特定 URL 路径（例如 /api）路由到 Laravel 应用，同时保持其他路径路由到其他服务（例如 React 应用）的问题。我们将重点介绍 Nginx 配置的关键部分，确保 PHP 文件能够被正确解析和执行。

在实际的 Web 应用开发中，经常需要将不同的 URL 路径指向不同的后端服务。例如，一个应用可能使用 React 构建前端，而使用 Laravel 构建 API 后端。本文将详细介绍如何配置 Nginx，使其能够根据 URL 路径将请求正确地路由到相应的服务，并确保 Laravel 应用中的 PHP 文件能够被正确解析。

配置 Nginx 以路由 /api 到 Laravel

假设我们希望将所有以 /api 开头的请求路由到 Laravel 应用，而其他请求则路由到 React 应用。我们需要在 Nginx 配置文件中进行相应的配置。

首先，我们需要定义一个 location 块来处理 /api 路径的请求。这个 location 块需要配置 PHP-FPM 来解析 PHP 文件。

location /api {
    alias /var/www/api/public/;
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ \.php$ {
    root /var/www/api/public;

    resolver 127.0.0.11;
    set $api api;
    fastcgi_split_path_info ^(.+\.php)(/.+)$;

    fastcgi_pass $api:9000;
    fastcgi_index index.php;
    include fastcgi_params;
    fastcgi_param SERVER_NAME $host;

    fastcgi_param SCRIPT_FILENAME $request_filename;
    fastcgi_param PATH_INFO $fastcgi_path_info;

    # 新增配置
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.0-fpm.sock;
}

登录后复制

代码解释：

location /api: 定义了处理 /api 路径的请求。
alias /var/www/api/public/: 将请求的根目录设置为 Laravel 应用的 public 目录。
try_files $uri $uri/ /index.php?$query_string;: 尝试查找请求的文件或目录。如果找不到，则将请求传递给 index.php。
location ~ \.php$: 定义了处理所有以 .php 结尾的请求。
root /var/www/api/public;: 指定 PHP 文件的根目录。
fastcgi_pass unix:/run/php/php8.0-fpm.sock;: 将 PHP 请求传递给 PHP-FPM 进行处理。 /run/php/php8.0-fpm.sock 是 PHP-FPM 的 Socket 文件路径，需要根据实际安装的 PHP 版本进行调整。
include snippets/fastcgi-php.conf;: 引入 Nginx 提供的默认 PHP FastCGI 配置，通常包含一些常用的 FastCGI 参数。

重要提示：

确保已经安装了 PHP-FPM，并且版本与 Nginx 配置中的 Socket 文件路径相匹配。例如，如果安装的是 PHP 8.0，则需要安装 php8.0-fpm。可以使用以下命令安装：

英特尔AI工具
英特尔AI与机器学习解决方案

70

查看详情
```
sudo apt-get install php8.0-fpm
```
登录后复制
根据实际的 PHP 版本，修改 fastcgi_pass 指令中的 Socket 文件路径。例如，如果使用的是 PHP 7.4，则路径可能是 /run/php/php7.4-fpm.sock。

配置 Nginx 以路由其他请求到 React

对于所有不以 /api 开头的请求，我们需要将其路由到 React 应用。假设 React 应用运行在 3000 端口，我们可以使用以下配置：

location / {
    index index.html;
    root /var/www/app;
    resolver 127.0.0.11;
    set $reactjs reactjs;
    proxy_pass http://$reactjs:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
}

登录后复制

代码解释：

location /: 定义了处理所有其他请求。
index index.html: 指定默认的索引文件为 index.html。
root /var/www/app: 指定 React 应用的根目录。
proxy_pass http://$react js:3000: 将请求代理到运行在 3000 端口的 React 应用。

完整 Nginx 配置示例

将上述配置组合在一起，一个完整的 Nginx 配置文件可能如下所示：

server {
    listen 80;
    server_name domain.com;

    root /var/www/app;
    index index.html;

    location /api {
        alias /var/www/api/public/;
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        root /var/www/api/public;

        resolver 127.0.0.11;
        set $api api;
        fastcgi_split_path_info ^(.+\.php)(/.+)$;

        fastcgi_pass $api:9000;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SERVER_NAME $host;

        fastcgi_param SCRIPT_FILENAME $request_filename;
        fastcgi_param PATH_INFO $fastcgi_path_info;

        # 新增配置
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.0-fpm.sock;
    }

    location / {
        index index.html;
        root /var/www/app;
        resolver 127.0.0.11;
        set $reactjs reactjs;
        proxy_pass http://$reactjs:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

登录后复制

注意事项

确保 Nginx 配置文件语法正确。可以使用 nginx -t 命令来检查配置文件的语法。
重启 Nginx 服务以应用新的配置。可以使用 sudo systemctl restart nginx 命令来重启 Nginx。
检查 PHP-FPM 是否正在运行。可以使用 sudo systemctl status php8.0-fpm 命令来检查 PHP-FPM 的状态（根据实际 PHP 版本修改命令）。
根据实际情况调整文件路径和端口号。