本文针对NGINX配置下PHP网站出现跳转404错误的问题，提供详细的解决方案。通过分析常见的配置错误，例如根目录配置不当和缺失关键的location块，指导读者正确配置NGINX，确保网站能够正确处理URL请求，避免出现404错误，保证网站的正常访问和功能使用。

当你的PHP网站在NGINX服务器上运行时，可能会遇到一个常见的问题：点击网站上的链接或按钮时，页面跳转到类似 /signin 或 /signup 的URL时出现404 Not Found错误。这通常表明NGINX服务器无法正确地将这些请求路由到你的PHP应用程序的入口文件（通常是index.php）。以下提供一种常见的解决方案。

问题分析

出现这种问题的原因通常是NGINX的配置不正确，导致它直接尝试在文件系统中查找与URL对应的文件或目录，而实际上这些URL应该由PHP应用程序处理。

立即学习“PHP免费学习笔记（深入）”；

解决方案

解决这个问题的关键是确保NGINX配置中包含一个location块，用于将所有未找到的URI重定向到index.php，并传递相应的查询字符串。

修改 Nginx 配置文件

1. 找到 Nginx 配置文件: 通常位于 /etc/nginx/sites-available/ 目录下，文件名可能与你的域名相关。

2. 编辑配置文件: 使用文本编辑器打开配置文件，例如 sudo nano /etc/nginx/sites-available/your_domain.com。

3. 添加或修改 location 块: 在 server 块中添加以下 location 块：

   server {
       listen 80;
       listen [::]:80;
       listen 443 ssl;
       listen [::]:443 ssl;
       root /root/var/www/myforum/public; # 确保路径正确
       index index.php index.html index.htm index.nginx-debian.html;
       server_name www.example.com;
   
       location / {
           try_files $uri $uri/ /index.php?$query_string;
       }
   
       location ~ \.php$ {
           try_files $uri $uri/ =404;
           fastcgi_split_path_info ^(.+\.php)(/.+)$;
           fastcgi_pass unix:/run/php/php7.4-fpm.sock;
           fastcgi_index index.php;
           fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
           include fastcgi_params;
       }
   
   }

   配置解释：

   • location / { ... }：这个块匹配所有请求。
   • try_files $uri $uri/ /index.php?$query_string;：这行代码的作用是：
     • 首先，尝试查找与请求URI匹配的文件 ($uri)。
     • 如果文件不存在，尝试查找与请求URI匹配的目录 ($uri/)。
     • 如果目录也不存在，则将请求重定向到 index.php，并将原始请求的查询字符串 ($query_string) 附加到URL上。

4. 检查 root 路径: 确保 root 指令指向你的网站的公共目录，也就是包含 index.php 文件的目录。 示例中的配置是 /root/var/www/myforum/public，根据你的实际情况修改。

5. 保存配置文件: 保存对配置文件的修改。

6. 测试 Nginx 配置: 运行 sudo nginx -t 命令来测试配置文件的语法是否正确。

7. 重新加载 Nginx: 运行 sudo systemctl reload nginx 命令来重新加载 Nginx 配置。

注意事项

• PHP-FPM 版本: 确保 fastcgi_pass 指令指向正确的 PHP-FPM socket 文件。在本例中是 unix:/run/php/php7.4-fpm.sock，如果你的PHP版本不同，需要修改为对应的socket文件。
• 文件权限: 确保 Nginx 进程拥有读取网站文件的权限。
• 错误日志: 如果问题仍然存在，查看 Nginx 的错误日志文件（通常位于 /var/log/nginx/error.log）以获取更多信息。

总结

通过添加或修改 location / 块，并使用 try_files 指令，我们可以告诉 Nginx 如何处理那些它找不到对应文件或目录的请求，从而将这些请求正确地传递给 PHP 应用程序。这可以有效地解决 PHP 网站在 Nginx 服务器上出现跳转 404 错误的问题。记住，仔细检查你的 Nginx 配置文件，确保所有的路径和参数都正确设置。