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

2024-04-13

Since IfIsEvil http://wiki.nginx.org/IfIsEvil我一直在尝试使用指令设置配置try_files只是为了让维护页面与响应代码 503 一起显示，对于任何 URI，无一例外，即包括 php 页面（如果存在维护文件）。

我的配置有两个问题：

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

我见过类似的问题[1] https://stackoverflow.com/q/5600448/1257965,[2] http://forum.nginx.org/read.php?2,226232但没有一个解决方案使用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指示？

edit:下面是一个解决方案，使用if我目前正在使用它，将其包含在服务器部分中：

error_page              503 @maintenance;

if (-f $document_root/maintenance.html) {
        return          503;
}

location @maintenance {
        try_files       /maintenance.html =404;
}

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

仅使用 nginx 且无 if 的可行解决方案

The try_files指示 http://nginx.org/en/docs/http/ngx_http_core_module.html#try_files仅对最后一条语句执行内部重定向。但我们可以将它与index指示 http://nginx.org/en/docs/http/ngx_http_index_module.html#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到位置块。

其他解决方案？

通过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 file:

set $maintenance 0;

如果您想激活维护模式（在您的 shell 中）：

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

给shell朋友更进阶例如，您甚至可以用它扩展初始化脚本我的 LSB 兼容的 https://github.com/Fleshgrinder/nginx-sysvinit-script通过替换文件末尾的以下块：

*)
  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 ... -->

本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系:hwhale#tublm.com(使用前将#替换为@)

Nginx