15

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

我的配置有两个问题：

  1. php URI 不会显示维护页面。
  2. 如果maintenance.html 文件存在，则不返回响应码503。

我见过类似的问题[1]，[2]但没有一个解决方案try_files只使用（而不是 usingif指令）并且无条件地提供响应代码为 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;
}
4

1 回答 1

10

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

仅使用 nginx 且没有 if 的有效解决方案

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

# 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到 location 块的原因。

其他解决方案？

通过 nginx 配置文件

与其创建一个 HTML 文件，不如创建一个 nginx 配置文件并简单地重新加载进程？

  • 性能好很多！
  • 更容易理解！
  • 无副作用！

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 脚本，例如我的 LSB 兼容脚本，通过替换文件末尾的以下块：

*)
  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 ... -->
于 2014-02-11T16:35:56.860 回答