Nginx+FPM+Laravel路由配置详解

在使用Nginx作为反向代理，并结合PHP-FPM运行Laravel应用时，如何实现指定URL路由配置？本文针对这一问题，详细介绍了如何配置Nginx，将特定URL路径（例如/api）路由到Laravel应用，同时保持其他路径路由到其他服务（如React应用）。重点讲解了Nginx配置的关键部分，确保PHP文件能够被正确解析和执行。通过本文，你将学会配置Nginx的location块，实现API请求的精准路由，并确保Laravel应用的PHP文件能够被PHP-FPM正确处理，从而构建一个高效、灵活的Web应用架构。掌握这些技巧，能有效提升Web应用的可维护性和扩展性。

本文旨在解决在使用 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。可以使用以下命令安装：

  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://$reactjs: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 版本修改命令）。
• 根据实际情况调整文件路径和端口号。

总结

通过以上配置，我们可以实现将特定 URL 路径路由到 Laravel 应用，同时保持其他路径路由到 React 应用。 关键在于正确配置 Nginx 的 location 块，并确保 PHP-FPM 能够正确解析 PHP 文件。 记住要根据实际的 PHP 版本和文件路径进行相应的调整。

终于介绍完啦！小伙伴们，这篇关于《Nginx+FPM+Laravel路由配置详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！