使用 Nginx 解决 PHP 应用 404 Not Found 问题

本文旨在解决 Nginx 服务器上 PHP 应用出现 404 Not Found 错误的问题，特别是当用户点击网站上的链接或按钮跳转到其他页面时。文章将分析 Nginx 配置中常见的错误，并提供有效的解决方案，确保 PHP 应用能够正确处理路由请求。

当你在 Nginx 服务器上部署 PHP 应用时，可能会遇到一个常见的问题：点击网站上的链接或按钮，跳转到其他页面时，出现 404 Not Found 错误。这通常意味着 Nginx 无法找到请求的资源。以下是解决此问题的常见方法和步骤。

问题分析

404 错误通常是由于 Nginx 配置不正确导致的。常见的原因包括：

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

• root 指令配置错误，导致 Nginx 无法找到网站根目录。
• 缺少处理 URL 重写的 location 块，导致 Nginx 无法将请求正确地路由到 index.php。
• PHP-FPM 配置错误，导致 Nginx 无法与 PHP 解释器通信。

解决方案

以下是一个经过验证的 Nginx 配置示例，可以解决上述问题：

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

56

查看详情

server {
    listen 80;
    listen [::]:80;
    listen 443 ssl; # 如果使用 HTTPS
    listen [::]:443 ssl; # 如果使用 HTTPS
    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$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }

    # SSL 配置 (如果使用 HTTPS)
    ssl_certificate /etc/nginx/ssl/example.com.crt;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;
}

配置详解

1. root 指令: 确保 root 指令指向网站的根目录。在这个例子中，是 /var/www/myforum/public。
2. index 指令: 指定 Nginx 默认加载的文件。
3. location / 块: 这是解决 404 问题的关键。try_files 指令会尝试按顺序查找文件或目录：
   • $uri: 请求的 URI。
   • $uri/: 请求的 URI 作为目录。
   • /index.php?$query_string: 如果前两者都找不到，则将请求重写到 index.php，并将原始查询字符串传递给它。这使得 PHP 应用可以处理路由。
4. location ~ \.php$ 块: 这个块处理 PHP 文件的请求。
   • fastcgi_pass: 指定 PHP-FPM 的地址。
   • fastcgi_param SCRIPT_FILENAME: 设置 SCRIPT_FILENAME 参数，告诉 PHP 解释器要执行的文件。
   • include fastcgi_params: 包含默认的 FastCGI 参数。

注意事项

• 检查路径: 仔细检查 root 指令中的路径是否正确。错误的路径是导致 404 错误的常见原因。
• PHP-FPM: 确保 PHP-FPM 正在运行，并且 fastcgi_pass 指向正确的地址。
• HTTPS: 如果使用 HTTPS，请确保已正确配置 SSL 证书。
• 缓存: 清除浏览器缓存，以确保加载最新的配置。
• 语法检查: 使用 nginx -t 命令检查 Nginx 配置文件的语法是否正确。

示例场景

假设你的 PHP 应用使用 index.php 作为入口点，并且通过 URL 中的参数或路由来处理不同的页面。例如，访问 /signin 页面实际上是由 index.php 处理的。如果没有 location / 块中的 try_files 指令，Nginx 会尝试在文件系统中查找名为 signin 的文件或目录，但它不存在，因此会返回 404 错误。

总结

通过正确配置 Nginx，特别是 location / 块中的 try_files 指令，可以解决 PHP 应用中的 404 Not Found 错误，确保 Nginx 将请求正确地路由到 PHP 解释器，从而使应用能够正常运行。请仔细检查你的配置，并确保所有路径和参数都正确设置。

以上就是使用 Nginx 解决 PHP 应用 404 Not Found 问题的详细内容，更多请关注php中文网其它相关文章！