Nginx 配置继承模型

要了解nginx的继承模型，首先需要知道nginx使用多个配置块进行操作。在nginx中，这样的块被称为上下文，例如，放置在服务器上下文中的配置指令驻留在server { }块中，就像放置在http上下文中的指令驻留在http { } 块中一样。

nginx中有6种可能的上下文，这里是从上到下的顺序：

Global.
Http.
Server.
If.
Location.

Nested Location.
If in location.
limit_except.

默认继承模型是指令仅向下继承。从来没有侧身，绝对永远不会。这包括您在内部从一个位置重写请求到另一个位置的情况 - 第一个位置中的每个指令都被遗忘，只有第二个位置指令适用于位置上下文。在继承行为方面，nginx中有四种类型的配置指令：

Normal指令 - 每个上下文一个值，例如：“root”或“index”。
Array指令 - 每个上下文有多个值，例如：“access_log”或“fastcgi_param”
Action指令 - 不只是配置的东西，例如：“rewrite”或“fastcgi_pass”
try_files指令。

Normal指令是迄今为止最常见的指令，它遵循默认的继承模型而没有任何意外。让我们看一个示例配置，显示行为的情况。

server {

    root /home/user/public_html;

    location /app {

        root /usr/share; # This results in /usr/share/app

                         # Full URI is ALWAYS appended.

    }

    location /app2 {

        // Server context root applies here.

    }

}

Array指令很像普通指令，因为它们遵循标准继承模型，它始终向下继承并替换在更高上下文中指定的任何指令。可能令人困惑的是假设你添加到数组。Array指令的行为是，如果在同一上下文中定义多个指令，则将添加到值，但如果在不同的上下文中定义多个指令，则较低的上下文将替换较高的上下文。这意味着如果您希望它在多个上下文中存在，您有时需要双重定义一个值。这种情况的一个例子。

server {

    access_log /var/log/nginx/access.log;

    include fastcgi.conf;

    location ~ ^/calendar/.+\.php$ {

        access_log /var/log/nginx/php-requests.log; # If this executes then server context one never does.

        fastcgi_param ENV debug; # This *overwrites* the higher context array.

        include fastcgi.conf     # Therefore we include it in *this* context again.

    }

}

Action指令是它开始变得有趣的地方。它们被限制在一个上下文中并且永远不会向下继承，但是它们可以在多个上下文中指定，并且在某些情况下将针对每个上下文执行。rewrite指令是一个action指令，允许在服务器和位置上下文中执行两个上下文。

server {

    rewrite ^/booking(.*) /calendar$1 permanent; # Always executes.

    location /calendar {

        rewrite ^ /index.php; # Can execute in addition to and does not replace server context rewrites.

    }

}

当然，它并不那么简单。在位置内有三种可能的上下文，一个嵌套位置，一个if和limit_except。指令的行为实际上完全取决于定义它的模块。如果在该上下文中允许，则所有normal和array指令都将正确继承。对于行动指令，故事有点不同。通常它们不会继承到嵌套位置，但最终取决于模块的预期，并且它可以在指令的基础上有所不同。这里没有使用nginx文档，所以你必须尝试一下，看看nginx是否会抱怨。为了更好地衡量，让我们举一个最常见的行为示例以及它如何影响重写：

server {

    location /calendar {

        rewrite ^ /static.php; # Executes unless inner location matches.

        location ~ \.php$ {

            fastcgi_pass backend; # Outer location context rewrite is not executed.

        }

    }

}

try_files指令与上面提到的每个其他操作指令大致相同，不同之处在于，如果放置在服务器上下文中，nginx实际上会创建一个伪位置，该位置是可能的最不具体的位置。这意味着如果请求与定义的位置匹配，则不会执行try_files指令。这意味着如果您有location / defined，那么您有一个匹配每个可能请求的位置，因此try_files永远不会实际执行。因此，如果可能的话，始终将try_files放在位置上下文而不是服务器上下文中

server {

    try_files $uri /index.php; # This never executes.

    location / {

        # Whatever here, or empty.

    }

    location ~ \.php$ {

        # If this location executes then try_files still does not execute.

        # Even if location / did not exist.

    }

}

关注微信公众号:lovephp

巴特西

Nginx 配置继承模型

最新文章

热门文章