本文旨在解决在使用 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 版本和文件路径进行相应的调整。
