yeskery

nginx 中 php-fpm 的 File not found 错误和 syntax error 语法错误的解决方法

File not found 错误

使用 php-fpm 解析 PHP,”No input file specified”,”File not found” 是令 nginx 新手头疼的常见错误,原因是 php-fpm 进程找不到 SCRIPT_FILENAME 配置的要执行的 .php 文件,php-fpm 返回给 nginx 的默认 404 错误提示。

比如我的网站doucument_root下没有test.php,访问这个文件时通过抓包可以看到返回的内容。

  1. HTTP/1.1 404 Not Found
  2. Date: Fri, 21 Dec 2012 08:15:28 GMT
  3. Content-Type: text/html
  4. Proxy-Connection: close
  5. Server: nginx/1.2.5
  6. X-Powered-By: PHP/5.4.7
  7. Via: 1.1 c3300 (NetCache NetApp/6.0.7)
  8. Content-Length: 16
  9. File not found.

很多人不想用户直接看到这个默认的404错误信息,想自定义404错误。

给出解决办法前我们来先分析下如何避免出现这类404错误,然后再说真的遇到这种情况(比如用户输入一个错误不存在的路径)时该怎么办,才能显示自定义的404错误页。

错误的路径被发送到php-fpm进程

出现这类错误,十个有九个是后端 fastcgi 进程收到错误路径(SCRIPT_FILENAME),而后端 fastcgi 收到错误路径的原因大都是配置错误。

常见的nginx.conf的配置如下:

  1. server {
  2. listen [::]:80;
  3. server_name example.com www.example.com;
  4. access_log /var/www/logs/example.com.access.log;
  5. location / {
  6. root /var/www/example.com;
  7. index index.html index.htm index.pl;
  8. }
  9. location /images {
  10. autoindex on;
  11. }
  12. location ~ .php$ {
  13. fastcgi_pass 127.0.0.1:9000;
  14. fastcgi_index index.php;
  15. fastcgi_param SCRIPT_FILENAME /var/www/example.com$fastcgi_script_name;
  16. include fastcgi_params;
  17. }
  18. }

这个配置中有很多不合理的地方,其中一个明显的问题就是 root 指令被放到了 location / 块。如果 root 指令被定义在 location 块中那么该 root 指令只能对其所在的 location 生效。其它 locaiont 中没有 root 指令,像 location /images 块不会匹配任何请求,需要在每个请求中重复配置 root 指令来解决这个问题。因此我们需要把 root 指令放在 server 块,这样各个 location 就会继承父 server 块定义的 $document_root,如果某个 location 需要定义一个不同的 $document_root,则可以在 location 单独定义一个 root 指令。

另一个问题就是 fastCGI 参数 SCRIPT_FILENAME 是写死的。如果修改了 root 指令的值或者移动文件到别的目录,php-fpm 会返回“No input file specified”错误,因为 SCRIPT_FILENAME 在配置中是写死的并没有随着 $doucument_root 变化而变化,我们可以修改 SCRIPT_FILENAME 配置如下:

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

所以我们不能忘记在 server 块中配置 root 指令,不然 $document_root 的值为空,只会传 $fastcgi_script_name 到 php-fpm,这样就会导致“No input file specified”错误。

请求的文件真的不存在

当 nginx 收到一个不在的 .php 文件的请求时,因为 nginx 只会检查 $uri 是否是 .php 结尾,不会对文件是否存在进行判断,.php 结尾的请求 nginx 会直接发给 php-fpm 处理。php-fpm 处理时找不到文件就会返回“No input file specified”带着“404 Not Found”头。

解决办法

我们在nginx拦截不存在的文件,请求并返回自定义404错误。

使用 try_files 捕捉不存在的urls并返回错误。

  1. location ~ .php$ {
  2. try_files $uri =404;
  3. fastcgi_pass 127.0.0.1:9000;
  4. fastcgi_index index.php;
  5. fastcgi_param SCRIPT_FILENAME ....
  6. ...................................
  7. ...................................
  8. }

上面的配置会检查.php文件是否存在,如果不存在,会返回404页面。

syntax error语法错误

在php程序出现类似 Parse error: syntax error, unexpected end of file in xxxxxxxx on line xx 的错误。

如果发现php的语法本身没有什么错误。就有可能是使用了短标签,例如:<? }?>

这种问题的解决方案是:可以在php.ini中设置 short_open_tag = on

short_open_tag 是什么呢?

决定是否允许使用代码开始标志的缩写形式(<? ?> )。如果要和 XML 结合使用 PHP,可以禁用此选项以便于嵌入使用 <?xml ?>。否则还可以通过php来输出,例如:<?php echo ‘<?xml version=”1.0”‘; ?> 。如果禁用了,必须使用 PHP 代码开始标志的完整形式(<?php ?> )。

注意:本指令也会影响到缩写形式 <?= ,它和 <? echo 等价。使用此缩写需要short_open_tag 的值为 on。

本文内容来自:

  1. http://www.nginx.cn/562.html
  2. https://blog.csdn.net/u014175572/article/details/52798684

评论

发表评论 点击刷新验证码

提示

该功能暂未开放