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

在部署基于 PHP 的 Web 应用时，开发者常常会遇到一个令人头疼的问题：页面返回“404 Not Found”。尤其是在使用 Nginx 作为 Web 服务器的场景下，这种错误尤为常见。与 Apache 不同，Nginx 并不会自动处理 PHP 文件的路由逻辑，一旦配置不当，即便是正确的 URL 请求也会被判定为资源不存在。本文将深入探讨这一问题的根源，并提供一套行之有效的解决方案。

为什么会出现 404 错误？

当用户访问 https://example.com/user/profile 这样的路径时，Web 服务器需要判断该请求是否对应一个真实存在的文件。在传统的静态网站中，每个 URL 都映射到服务器上的具体文件，比如 profile.html。但在现代 PHP 框架（如 Laravel、ThinkPHP、Symfony）中，大多数请求都会被统一交由一个入口文件（通常是 index.php）来处理。这种机制称为“前端控制器模式”。

Nginx 默认的行为是查找物理路径是否存在。如果 /user/profile 在文件系统中没有对应的目录或文件，Nginx 就会直接返回 404，而根本不会把请求交给 PHP-FPM 处理。这正是问题的关键所在——Nginx 没有正确地将动态请求转发给 PHP 引擎。

核心配置：利用 try_files 指令

解决这个问题的核心在于 Nginx 的 try_files 指令。它允许我们定义一组文件路径的查找顺序，只有当所有路径都不存在时，才执行最后的回退操作。对于 PHP 应用，这个回退动作通常就是将请求重定向到 index.php。

以下是一个典型的 Nginx server 块配置：

nginx
server {
listen 80;
server_name example.com;
root /var/www/html/public;
index index.php;

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ \.php$ {
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

location ~ /\.ht {
    deny all;
}

}

在这个配置中，try_files $uri $uri/ /index.php?$query_string; 是关键。它的含义是：首先检查请求的 URI 是否对应一个静态文件；如果不是，再检查是否是一个目录；如果都不是，则将请求交给 index.php，并保留原始查询参数。这样一来，即使 URL 看起来像是多级路径，也能被正确路由到 PHP 入口文件进行处理。

注意事项与常见误区

许多开发者在配置时容易忽略 SCRIPT_FILENAME 参数的设置。如果这个变量没有正确指向当前请求的 PHP 脚本，即使请求被转发了，PHP-FPM 也无法执行正确的文件，最终仍可能返回空白或 502 错误。因此，确保 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 这一行存在且路径正确至关重要。

此外，项目结构也会影响配置效果。例如，在 Laravel 中，入口文件位于 public/index.php，因此 root 指令应指向 public 目录，而不是项目的根目录。若将 root 设置错误，会导致静态资源无法访问或 PHP 文件暴露在公网中，带来安全风险。

伪静态与 URL 友好性

通过上述配置，不仅可以解决 404 问题，还能实现 URL 的美化。用户不再需要看到 index.php?controller=user&action=profile 这类冗长的地址，而是可以直接使用 /user/profile 这样简洁、语义清晰的路径。这对于 SEO 和用户体验都有显著提升。

同时，这种机制也为后续扩展提供了便利。比如可以轻松添加缓存规则、限制访问频率、启用 HTTPS 重定向等，而无需修改应用本身的代码逻辑。

总结

Nginx 本身并不理解 PHP 应用的路由机制，必须通过合理的配置引导其正确处理动态请求。try_files 指令是连接 Nginx 与 PHP-FPM 的桥梁，它让服务器在找不到静态资源时，仍然能够将控制权交给 PHP 来完成后续逻辑。只要掌握这一核心思想，并结合实际项目结构调整路径参数，就能彻底解决 PHP 应用中的 404 问题，构建出稳定、高效、易于维护的 Web 服务环境。