nginx的;如果文件仅使用try_files存在,则返回响应代码

时间:2013-05-22 13:33:35

标签: nginx

IfIsEvil以来,我一直在尝试使用指令try_files设置配置,以便维护页面与响应代码503一起显示,对于任何URI都没有例外,即包括php页面,如果存在维护文件。

我的配置存在两个问题:

  1. 不会显示php URI的维护页面。
  2. 如果maintenance.html文件存在,则不会返回响应代码503。
  3. 我见过类似的问题[1][2],但没有一个解决方案只使用try_files(而不是使用if指令)并且无条件服务如果存在相应的文件,则具有响应代码503的维护页面。这样的解决方案可能吗?

    以下是我目前的非工作conf文件。它不包含503响应代码设置,因为我不明白它应该去哪里以使其如上所述工作。

    worker_processes            1;
    
    error_log                   /var/log/nginx/error.log debug;
    
    events {
        worker_connections      1024;
    }
    
    http {
        include                 mime.types;
        default_type            application/octet-stream;
    
        index                   index.php index.html index.htm;
    
        server {
            listen                  80;
            server_name             rpi;
            root                    /www;
    
            location / {
                try_files           /maintenance.html $uri $uri/ /index.php?$args;
    
                # pass the PHP scripts to FastCGI server
                location ~ \.php$ {
                    try_files           $uri =404;
                    fastcgi_pass        unix:/run/php-fpm/php-fpm.sock;
                    fastcgi_index       index.php;
                    include             fastcgi.conf;
                }
            }
        }
    }
    

    我想我的问题也可以这样说:try_files可以作为if控制结构使用吗?如果不是单独的话,可以将上述目标与其他指令结合起来,排除if指令吗?

    编辑:以下是我正在使用的if解决方案,将其包含在服务器部分中:

    error_page              503 @maintenance;
    
    if (-f $document_root/maintenance.html) {
            return          503;
    }
    
    location @maintenance {
            try_files       /maintenance.html =404;
    }
    

1 个答案:

答案 0 :(得分:9)

非常好的问题!但除非你调用某种设置正确响应代码的脚本,否则根本不可能。

只有nginx的工作解决方案,否则为

try_files directive仅对最后一个语句执行内部重定向。但是我们可以将它与index directive结合起来并强制进行内部重定向。

# This will be the HTML file to display for the 503 error.
error_page 503 /maintenance/maintenance.html;

# Let nginx know that this particular file is only for internal redirects.
location = /maintenance/maintenance.html {
  internal;
}

# Any request that starts with the maintenance folder is 503!
location ^~ /maintenance/ {
  return 503;
}

# Instead of checking if a file exists and directly delivering it we check
# if a certain directory exists and trigger our index directive which will
# perform an internal redirect for us.
location / {
  expires epoch;
  try_files /maintenance/ $uri $uri/ /index.php?$args;
}

这种方法有什么缺点吗?

  • 实际301重定向到目录,而不是停留在相同的URL(搜索引擎)。
  • 浏览器缓存301重定向可能是一个问题,这就是我将expires epoch添加到位置块的原因。

其他解决方案?

通过nginx配置文件

为什么不创建一个nginx配置文件而只是重新加载进程,而不是创建HTML文件?

  • 表现好多了!
  • 更容易理解!
  • 没有副作用!

nginx配置可能如下所示(注意这个if根本不是邪恶的):

error_page 503 /maintenance.html;

location / {
  include maintenance.conf;
  if ($maintenance = 1) {
    return 503;
  }
  try_files $uri $uri/ /index.php?$args;
}

maintenance.conf文件的内容:

set $maintenance 0;

如果你想激活维护模式(在你的shell中):

echo set $maintenance 1;> maintenance.conf && service nginx reload

对shell朋友更高级 您甚至可以使用此扩展init脚本,例如my LSB compliant one通过替换文件末尾的以下块:

*)
  echo "Usage: ${NAME} {force-reload|reload|restart|start|status|stop}" >&2
  exit 1
;;

使用以下块:

maintenance)
  echo "set $maintenance 1;" > /etc/nginx/maintenance.conf && service nginx reload;
;;

production)
  echo "set $maintenance 0;" > /etc/nginx/maintenance.conf && service nginx reload;
;;

*)
  echo "Usage: ${NAME} {force-reload|reload|restart|start|status|stop|maintenance|production}" >&2
  exit 1
;;

现在您只需执行以下命令(包括自动完成)即可进入维护模式:

service nginx maintenance

或以下内容重新投入生产:

service nginx production

使用脚本/ PHP文件

另一个非常简单的方法就是使用一个处理它的PHP文件。

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

您的PHP文件看起来与您的HTML文件完全相同,您只需在其开头添加以下内容(假设PHP 5.4 +):

<?php http_response_code(503) ?><!doctype html>
<html>
<head>
<!-- ... more html ... -->