本文旨在解决 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 配置示例，可以解决上述问题：
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;
}配置详解
- root 指令: 确保 root 指令指向网站的根目录。在这个例子中，是 /var/www/myforum/public。
- index 指令: 指定 Nginx 默认加载的文件。
-
location / 块: 这是解决 404 问题的关键。try_files 指令会尝试按顺序查找文件或目录：
- $uri: 请求的 URI。
- $uri/: 请求的 URI 作为目录。
- /index.php?$query_string: 如果前两者都找不到，则将请求重写到 index.php，并将原始查询字符串传递给它。这使得 PHP 应用可以处理路由。
-
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 解释器，从而使应用能够正常运行。请仔细检查你的配置，并确保所有路径和参数都正确设置。
