아파치 모듈 mod_setenvif

가능한 언어: en | - ja | - ko | - tr

이 문서는 최신판 번역이 아닙니다. - 최근에 변경된 내용은 영어 문서를 참고하세요.

- - - -

설명:	요청의 성격에 따라 환경변수 설정을 변경한다
상태:	Base
모듈명:	setenvif_module
소스파일:	mod_setenvif.c

요약

- - -

mod_setenvif 모듈은 요청의 성격이 - 정규표현식에 해당하는지 여부로 환경변수를 설정한다. 서버의 - 다른 부분이 행동을 결정할때 이 환경변수를 사용할 수 있다.

- -

설정파일에 나오는 순서대로 지시어를 처리한다. 그래서 - 브라우저가 MSIE가 아니라 mozilla인 경우 netscape를 - 설정하는 아래 예와 같이 여러 지시어를 함께 사용할 수 있다.

- -

- BrowserMatch ^Mozilla netscape - BrowserMatch MSIE !netscape -

참고

아파치의 환경변수

- -

BrowserMatch 지시어

- - - - - - - -

설명:	HTTP User-Agent에 따라 환경변수를 설정한다
문법:	`BrowserMatch regex [!]env-variable[=value] -[[!]env-variable[=value]] ...`
사용장소:	주서버설정, 가상호스트, directory, .htaccess
Override 옵션:	FileInfo
상태:	Base
모듈:	mod_setenvif

BrowserMatch는 SetEnvIf 지시어의 특별한 - 경우로, HTTP 요청 헤더 User-Agent에 따라 환경변수를 - 설정한다. 다음 두 줄은 같다:

- BrowserMatchNoCase Robot is_a_robot - SetEnvIfNoCase User-Agent Robot is_a_robot -

- -

추가 예제:

- BrowserMatch ^Mozilla forms jpeg=yes browser=netscape - BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript - BrowserMatch MSIE !javascript -

- -

BrowserMatchNoCase 지시어

- - - - - - - - -

설명:	대소문자를 구별하지않고 User-Agent에 따라 환경변수를 -설정한다
문법:	`BrowserMatchNoCase regex [!]env-variable[=value] - [[!]env-variable[=value]] ...`
사용장소:	주서버설정, 가상호스트, directory, .htaccess
Override 옵션:	FileInfo
상태:	Base
모듈:	mod_setenvif
지원:	아파치 1.2 이상 (아파치 1.2에서 이 지시어는 현재 - 없어진 mod_browser 모듈에 있었다)

- -

BrowserMatchNoCase 지시어는 BrowserMatch 지시어와 - 의미상 같다. 그러나 이 지시어는 대소문자를 구별하지않는다. - 예를 들어:

- BrowserMatchNoCase mac platform=macintosh - BrowserMatchNoCase win platform=windows -

- -

BrowserMatch와 - BrowserMatchNoCase 지시어는 - SetEnvIf와 - SetEnvIfNoCase - 지시어의 특별한 경우다. 다음 주 줄은 같다:

- BrowserMatchNoCase Robot is_a_robot - SetEnvIfNoCase User-Agent Robot is_a_robot -

- -

SetEnvIf 지시어

- - - - - - - -

설명:	요청의 성질에 따라 환경변수를 설정한다
문법:	`SetEnvIf attribute - regex [!]env-variable[=value] - [[!]env-variable[=value]] ...`
사용장소:	주서버설정, 가상호스트, directory, .htaccess
Override 옵션:	FileInfo
상태:	Base
모듈:	mod_setenvif

SetEnvIf 지시어는 요청의 성질에 - 따라 환경변수를 정의한다. 첫번째 아규먼트 attribute는 - 다음 세가지중 하나다:

- -

HTTP 요청 헤더 (더 자세한 정보는 RFC2616 - 참고); 예를 들어: Host, User-Agent, - Referer, Accept-Language. 정규표현식을 - 사용하여 여러 요청 헤더를 지칭할 수 있다.
요청의 다음 성질중 하나: -
- Remote_Host - (있다면) 요청하는 클라이언트의 - 호스트명
- Remote_Addr - 요청하는 클라이언트의 IP 주소
- Server_Addr - 요청을 받는 서버의 IP 주소 - (2.0.43 버전 이후에만)
- Request_Method - 사용한 메써드 이름 - (GET, POST, 등등)
- Request_Protocol - 요청의 프로토콜 이름과 - 버전 (예를 들어, "HTTP/0.9", "HTTP/1.1", 등.)
- Request_URI - HTTP 요청에서 요청한 자원 - -- 일반적으로 URL에서 질의문자열을 제외한 스킴(scheme)과 - 호스트 이후 부분
-
요청과 연관된 환경변수 이름. 그래서 SetEnvIf -지시어는 이전 지시어의 결과를 검사할 수 있다. 이전에 -SetEnvIf[NoCase] 지시어로 정의한 환경변수만을 -검사할 수 있다. '이전'이란 (서버전역과 같이) 더 넓은 영역 혹은 -지시어의 현재 영역 이전을 뜻한다. 요청 성질이 아니고 정규표현식이 -아닌 attribute는 환경변수로 취급한다.

- -

두번째 아규먼트는 (regex) Perl 호환 정규표현식이다. -이는 POSIX.2 egrep의 정규표현식과 비슷하다. regex가 -attribute에 대응하면 나머지 아규먼트를 처리한다.

- -

나머지 아규먼트는 설정할 변수명과 (선택적인) 설정값들이다. -다음과 같은 형식이다

- -

varname, 혹은
!varname, 혹은
varname=value

- -

첫번째 형태는 값으로 "1"을 사용한다. 두번째 형태는 변수가 - 이미 정의된 경우 변수를 제거하고, 세번째는 변수의 값으로 - value를 설정한다. 아파치 2.0.51부터 - value에 있는 $1..$9를 - regex의 괄호친 하위표현식으로 대체한다.

- -

예제:

- - SetEnvIf Request_URI "\.gif$" object_is_image=gif - SetEnvIf Request_URI "\.jpg$" object_is_image=jpg - SetEnvIf Request_URI "\.xbm$" object_is_image=xbm - : - SetEnvIf Referer www\.mydomain\.com intra_site_referral - : - SetEnvIf object_is_image xbm XBIT_PROCESSING=1 - : - SetEnvIf ^TS* ^[a-z].* HAVE_TS -

- -

처음 세 줄은 이미지 파일을 요청한 경우 환경변수 - object_is_image를 설정한다. 네번째 줄은 페이지를 - www.mydomain.com 웹사이트에서 참조한 경우 - intra_site_referral을 설정한다.

- -

마지막 예는 요청에 이름에 "TS"로 시작하고 값이 [a-z] - 중 하나로 시작하는 헤더가 있는 경우 환경변수 - HAVE_TS를 설정한다.

- -

참고

아파치의 환경변수에 더 많은 -예제가 있다. -

SetEnvIfNoCase 지시어

- - - - - - - - -

설명:	대소문자를 구별하지않고 요청의 성질에 따라 환경변수를 -설정한다
문법:	`SetEnvIfNoCase attribute regex - [!]env-variable[=value] - [[!]env-variable[=value]] ...`
사용장소:	주서버설정, 가상호스트, directory, .htaccess
Override 옵션:	FileInfo
상태:	Base
모듈:	mod_setenvif
지원:	아파치 1.3 이후

- -

SetEnvIfNoCase는 의미상 SetEnvIf 지시어와 같지만, - 대소문자를 구별하지않고 정규표현식을 찾는다. 예를 들어:

- SetEnvIfNoCase Host Apache\.Org site=apache -

- -

이 경우 HTTP 요청 헤더 Host:가 - Apache.Org, apache.org 등을 포함하면 - site 환경변수를 "apache"로 설정한다.

- -