自IfIsEvil以来,我一直在尝试使用指令try_files
设置配置,以便维护页面与响应代码503一起显示,对于任何URI都没有例外,即包括php页面,如果存在维护文件。
我的配置存在两个问题:
我见过类似的问题[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;
}
答案 0 :(得分:9)
非常好的问题!但除非你调用某种设置正确响应代码的脚本,否则根本不可能。
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;
}
expires epoch
添加到位置块的原因。为什么不创建一个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文件。
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 ... -->