nginx rewrite 플래그의 차이점: last 와 break

발생일: 2014.12.17

키워드: nginx rewrite flags, last, break

문제:
nginx 의 rewrite 디렉티브에는 4가지 플래그(last, break, redirect, permanent)가 있는데, 그 중 last 와 break 는 자꾸 봐도 헷갈린다.
나중에 봐도 헷갈리지 않게 자세히 정리했다.


해결책:

API 문서에 있는 정의는 다음과 같다. (http://wiki.nginx.org/HttpRewriteModule)

Flags can be any of the following:

last - completes processing of current rewrite directives and restarts the process (including rewriting) with a search for a match on the URI from all available locations.
break - completes processing of current rewrite directives and non-rewrite processing continues within the current location block only.
redirect - returns temporary redirect with code 302; it is used if the substituting line begins with http://
permanent - returns permanent redirect with code 301



이 중에 last 와 break 플래그의 정의를 좀 더 쉽게 (우리말로) 바꿔보면 아래와 같다.

last: rewrite 직후에 현재 블럭의 프로세싱을 종료하고 다음 URI 매칭을 찾아 진행한다.
break: rewrite 이후 현재 블럭을 마지막으로 프로세싱을 종료한다. 단, 현재 블럭 내에서 rewrite 가 아닌 작업까진 진행한다.


두 플래그의 동작 방식은 특히 헷갈려서, 쉽게 이해할 수 있는 예제를 만들었다.
(라인을 쉽게 설명하기 위해 A0, A1, … 과 같이 붙여놓았다)


A0   location /a {
A1     rewrite ^ /b;
A2     rewrite ^ /c;
A3     add_header x-a a;
A4     proxy_set_header foo foo;
A5     proxy_pass http://localhost:3000;
A6   }

B0   location /b { # B
B1     add_header x-b b;
B2     proxy_pass http://localhost:3000;
B3   }

C0   location /c { # C
C1     rewrite ^ /d;
C2     add_header x-c c;
C3     proxy_pass http://localhost:3000;
C4   }

D0   location /d { # D
D1     add_header x-d d;
D2     proxy_pass http://localhost:3000;
D3   }


nginx 룰이 위와 같은 때, `/a`로 요청을 할 경우 다음과 같은 순서로 룰이 적용된다.

`/a` 요청 시:
A0 -> A1 -> A2 -> C0 -> C1 -> D0 -> D1 -> D2

기본적으로 블럭 내에 rewrite 룰이 있으면, rewrite 을 수행한 후 해당 블럭의 프로세싱을 종료하고 변경된 URI 룰을 찾아 이동한다.


A0   location /a {
A1     rewrite ^ /b last;
A2     rewrite ^ /c;
A3     add_header x-a a;
A4     proxy_set_header foo foo;
A5     proxy_pass http://localhost:3000;
A6   }

위와 같이 `last` 플래그를 사용하면, 다음과 같이 `last` 플래그를 마지막으로 rewrite 를 종료한다.

`/a` 요청 시:
A0 -> A1 -> B0 -> B1 -> B2



A0   location /a {
A1     rewrite ^ /b break;
A2     rewrite ^ /c;
A3     add_header x-a a;
A4     proxy_set_header foo foo;
A5     proxy_pass http://localhost:3000;
A6   }

`break` 플래그를 사용하면, 현재 블럭 내에서의 rewrite 작업을 break 플래그가 있는 디렉티브에서 종료하고,
현재 블럭 내의 rewrite 가 아닌 다른 작업을 진행하고 프로세싱을 종료한다.

`/a/` 요청 시:
A0 -> A1 -> A3 -> A4 -> A5




이렇게 정리해두니 또 간단하네… -_-
여튼, 이제 헷갈리지 말자. ㅎㅎ


저작자 표시 비영리 변경 금지
신고