本文旨在解决nginx在执行特定php脚本时返回404错误的问题。通过分析nginx的`location`块配置，特别是`try_files`和`fastcgi_split_path_info`指令，我们将提供一个针对特定脚本路径的优化配置方案，确保nginx能正确地将php请求转发给php-fpm处理，从而避免404错误，并提升配置的精确性与健壮性。
在Nginx服务器环境中，当尝试访问一个PHP脚本时，如果服务器返回404错误，即使文件实际存在且静态文件（如.txt）可以正常访问，这通常意味着Nginx未能正确识别请求为PHP脚本，或者未能将其正确地转发给PHP-FPM处理器。本文将深入探讨这一问题，并提供一个具体的解决方案。
问题分析：Nginx PHP 404 错误的常见原因
典型的Nginx配置中，处理PHP请求的location块通常如下所示：
location ~ \.php$ {
try_files $uri =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/run/php/php7.4-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}登录后复制
这个配置旨在匹配所有以.php结尾的请求。然而，当特定脚本（例如位于/var/www/myproyect/public/scripts/myscript.php）返回404时，可能的原因包括：
-
try_files $uri =404; 的误判： 此指令会尝试按顺序查找文件。如果$uri（即请求的URI，如/scripts/myscript.php）在document_root下无法直接找到对应的文件，它会立即返回404。这可能发生在当document_root指向/var/www/myproyect/public，但脚本位于其子目录/scripts/时，Nginx可能未能正确解析路径。
-
fastcgi_split_path_info 的解析问题： 这个指令负责将URI分割成SCRIPT_FILENAME（脚本路径）和PATH_INFO（额外路径信息）。如果正则表达式不匹配或匹配不当，SCRIPT_FILENAME可能无法正确设置，导致PHP-FPM找不到脚本。
-
SCRIPT_FILENAME 参数不正确： fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 依赖于$document_root和$fastcgi_script_name的正确组合。如果$fastcgi_script_name没有被fastcgi_split_path_info正确设置，或者$document_root与实际脚本路径不符，PHP-FPM将无法找到文件。
解决方案：针对特定脚本路径的优化配置
针对上述问题，特别是当只有特定路径下的PHP脚本出现404时，我们可以采用更精确的location块配置来解决。以下是一个针对/scripts/myscript.php路径的有效配置示例：
立即学习“PHP免费学习笔记（深入）”；
location ~ /scripts/myscript.php {
try_files $uri $is_args$args;
error_page 405 =200 $uri; # 解决POST请求可能遇到的405错误，非404问题核心
fastcgi_split_path_info ^(.+\.php)(/.+)$; # 修正为通用且健壮的正则表达式
fastcgi_pass unix:/run/php/php7.4-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}登录后复制
配置详解：
-
location ~ /scripts/myscript.php { ... }
- 此指令精确匹配对/scripts/myscript.php的请求。与通用的location ~ \.php$相比，它提供了更高的优先级和更强的针对性，确保此配置块专门处理该特定脚本。当存在多个location块时，Nginx会优先选择最精确的匹配。
-
try_files $uri $is_args$args;
- 这是解决404问题的关键之一。它告诉Nginx首先尝试查找与$uri对应的文件。如果找到，则直接服务。
- $is_args$args是一个特殊的Nginx变量，它表示请求中的查询字符串（例如?param=value）。如果前一个尝试失败，Nginx会尝试将请求重写到带有查询字符串的URI。对于PHP脚本，这通常意味着将请求传递给FastCGI处理器，而不是直接返回404。通过这种方式，即使Nginx最初没有将URI识别为文件，它也会尝试将其作为参数传递。
-
与try_files $uri =404;的区别： 后者在找不到$uri时直接返回404，而前者在找不到文件时，会尝试将请求内部重定向到带有查询参数的URI，这通常会导致请求被FastCGI处理。
-
error_page 405 =200 $uri;
- 此指令用于处理HTTP 405 Method Not Allowed错误。当客户端使用不允许的方法（如POST）访问一个Nginx配置为只允许GET/HEAD的资源时，Nginx会返回405。此行配置会将405错误转换为200 OK，并尝试再次处理原始URI。请注意，这并非直接解决PHP 404问题的核心，但它存在于提供的有效配置中，通常用于确保某些特定场景下（例如POST请求到PHP脚本）的兼容性。
-
fastcgi_split_path_info ^(.+\.php)(/.+)$;
- 此指令使用正则表达式将请求URI分割为两部分：$fastcgi_script_name和$fastcgi_path_info。
- ^(.+\.php)：匹配从开头到.php的所有字符，这部分将成为$fastcgi_script_name。
- (/.*)$：匹配.php之后的所有字符（如果存在），这部分将成为$fastcgi_path_info。
-
重要提示： 原始问题提供的解决方案中，此正则表达式为^(.\.php)(/.)$。这个正则表达式非常具体，.\.php仅匹配一个字符后跟.php（如a.php），并且/.也只匹配一个字符的路径信息。对于myscript.php这样的脚本名，它将无法正确匹配。因此，为了通用性和健壮性，我们应使用^(.+\.php)(/.+)$或^(.+\.php)(.*)$这样的标准表达式，确保myscript.php能被正确识别为脚本名。
-
fastcgi_pass unix:/run/php/php7.4-fpm.sock;
- 指定PHP-FPM的Unix套接字路径。Nginx将通过此套接字将请求转发给PHP-FPM进程处理。
-
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
- 设置SCRIPT_FILENAME FastCGI参数，这是PHP-FPM用来查找并执行脚本的关键路径。它由Nginx的document_root和fastcgi_split_path_info解析出的$fastcgi_script_name组合而成。
-
include fastcgi_params;
- 引入Nginx默认的FastCGI参数文件，其中包含了一系列PHP-FPM所需的标准参数（如REQUEST_METHOD, CONTENT_TYPE等）。
部署与验证
-
修改Nginx配置： 将上述优化后的location块添加到你的Nginx站点配置文件中，通常位于/etc/nginx/sites-available/your_site。
-
测试配置： 执行sudo nginx -t命令检查配置文件的语法是否正确。
-
重载Nginx： 如果语法无误，执行sudo systemctl reload nginx（或sudo service nginx reload）使配置生效。
-
验证： 使用curl -I https://myurl/scripts/myscript.php或直接在浏览器中访问该URL，确认不再返回404错误，而是返回PHP脚本的正确响应（例如200 OK）。
注意事项与最佳实践
-
document_root的设置： 确保你的Nginx server块中的root指令指向正确的文档根目录（例如/var/www/myproyect/public），因为SCRIPT_FILENAME的构建依赖于它。
-
location块的顺序： Nginx处理location块的顺序很重要。精确匹配（如=）优先于前缀匹配（如^~），而正则表达式匹配（如~）在没有前缀匹配时才进行评估。通常，更具体的location块应放在更通用的块之前，或者确保它们的匹配逻辑不会冲突。
-
PHP-FPM状态： 确保PHP-FPM服务正在运行且监听正确的套接字或端口。可以通过sudo systemctl status php7.4-fpm（或相应版本）来检查。
-
日志分析： 如果问题依然存在，检查Nginx的错误日志（通常在/var/log/nginx/error.log）和PHP-FPM的错误日志，它们会提供更详细的错误信息。
-
权限问题： 确保Nginx用户（通常是www-data）对PHP脚本及其父目录具有读取和执行权限。
通过采用这种针对性的Nginx配置，你可以有效地解决特定PHP脚本执行时出现的404错误，确保Web服务器能够正确地处理PHP请求，从而提供稳定可靠的服务。
以上就是Nginx PHP脚本执行404错误排查与解决方案的详细内容，更多请关注php中文网其它相关文章！
489
收藏
