NGINX配置导致PHP网站跳转404错误解决方案-php教程-PHP中文网

NGINX配置导致PHP网站跳转404错误解决方案

碧海醫心

发布： 2025-11-16 12:08:16

原创

256人浏览过

nginx配置导致php网站跳转404错误解决方案

本文针对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 配置文件

找到 Nginx 配置文件: 通常位于 /etc/nginx/sites-available/ 目录下，文件名可能与你的域名相关。
编辑配置文件: 使用文本编辑器打开配置文件，例如 sudo nano /etc/nginx/sites-available/your_domain.com。

标贝悦读AI配音
在线文字转语音软件-专业的配音网站

20

查看详情

添加或修改 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上。

检查 root 路径: 确保 root 指令指向你的网站的公共目录，也就是包含 index.php 文件的目录。示例中的配置是 /root/var/www/myforum/public，根据你的实际情况修改。
保存配置文件: 保存对配置文件的修改。
测试 Nginx 配置: 运行 sudo nginx -t 命令来测试配置文件的语法是否正确。
重新加载 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 配置文件，确保所有的路径和参数都正确设置。

以上就是NGINX配置导致PHP网站跳转404错误解决方案的详细内容，更多请关注php中文网其它相关文章！