아파치의 환경변수 - Apache HTTP Server Version 2.2

Apache HTTP Server Version 2.2

Apache > HTTP Server > Documentation > Version 2.2

#### Please note

This document refers to a legacy release (2.2) of Apache httpd. The active release (2.4) is documented here. If you have not already upgraded, please follow this link for more information.

You may follow this link to go to the current version of this document.

# 아파치의 환경변수

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

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

아파치 웹서버는 환경변수(environment variable)라는 변수에 정보를 저장할 수 있다. 이 정보를 사용하여 로그나 접근제어 등 여러 작업을 조절한다. 또, 환경변수는 CGI 스크립트와 같은 외부 프로그램과 통신하는 수단이 된다. 이 문서는 환경변수를 다루고 사용하는 다양한 방법들을 설명한다.

이 변수들을 환경변수라고 부르지만, 운영체제에서 말하는 환경변수와 다르다. 이 변수는 아파치 내부에 저장되고 사용된다. 환경변수는 CGI 스크립트나 Server Side Include 스크립트로 넘겨질때만 실제 운영체제 환경변수가 된다. 서버를 실행하는 운영체제 환경을 수정하고 싶다면 운영체제 쉘에서 환경을 수정해야 한다.

- Comments

## 환경변수 설정하기

관련된 모듈 | 관련된 지시어
--- | ---

- `mod_env`
- `mod_rewrite`
- `mod_setenvif`
- `mod_unique_id`

- `BrowserMatch`
- `BrowserMatchNoCase`
- `PassEnv`
- `RewriteRule`
- `SetEnv`
- `SetEnvIf`
- `SetEnvIfNoCase`
- `UnsetEnv`

### 기본적인 환경설정

아파치에서 환경변수를 설정하는 가장 기본적인 방법은 무조건적인 `SetEnv` 지시어를 사용하는 것이다. `PassEnv` 지시어를 사용하여 서버를 시작한 쉘에서 환경변수를 가져올 수도 있다.

### 요청에 따른 조건부 설정

더 유연하게, mod_setenvif가 제공하는 지시어는 요청마다 요청의 특징에 따라 환경변수를 설정한다. 예를 들어, 특정 브라우저로 (User-Agent) 요청하거나 특정 Referer (맞춤법이 틀리지 않았다) 헤더가 있는 경우에만 변수를 설정할 수 있다. 심지어 mod_rewrite에 있는 `RewriteRule`의 `[E=...]` 옵션을 사용하여 더 유연하게 환경변수를 설정할 수도 있다.

### 유일한 식별자

마지막으로 mod_unique_id는 각 요청에 대해 어떤 경우에도 "모든" 요청중에 확실히 유일한(겹치지않은) 값으로 `UNIQUE_ID` 환경변수를 설정한다.

### 표준 CGI 변수

CGI 스크립트와 SSI 문서는 아파치 설정에서 설정하였거나 쉘에서 가져온 환경변수 외에 추가로 CGI 규약이 규정한 요청에 대한 정보를 알려주는 환경변수들을 받는다.

### 주의할 점

- 환경설정 지시어를 사용하여 표준 CGI 변수를 무시하거나 수정할 수 없다.
- suexec가 CGI 스크립트를 실행하는 경우, 시작하기전에 CGI 스크립트의 환경은 안전한 변수들만 가지도록 청소된다. 안전한 변수 목록은 컴파일시 `suexec.c`에 정의된다.
- 포팅을 위해 환경변수 이름에는 오직 문자, 숫자, 밑줄문자만 사용하는 것이 좋다. 또, 첫번째 문자로 숫자를 사용하지않는 것이 좋다. CGI 스크립트나 SSI 페이지에 넘어갈때 이외의 문자는 밑줄로 대체된다.

## 환경변수 사용하기

관련된 모듈 | 관련된 지시어
--- | ---

- `mod_authz_host`
- `mod_cgi`
- `mod_ext_filter`
- `mod_headers`
- `mod_include`
- `mod_log_config`
- `mod_rewrite`

- `Allow`
- `CustomLog`
- `Deny`
- `ExtFilterDefine`
- `Header`
- `LogFormat`
- `RewriteCond`
- `RewriteRule`

### CGI 스크립트

환경변수의 주된 용도중 하나는 CGI 스크립트와 정보를 교환하는 것이다. 앞에서 설명했듯이 아파치 설정에서 설정한 변수외에 요청에 대한 표준 정보를 가진 변수가 CGI 스크립트로 넘어간다. 더 자세한 내용은 CGI 투토리얼을 참고하라.

### SSI 페이지

mod_include의 `INCLUDES` 필터가 처리하는 서버파싱 (SSI) 문서는 `echo` 요소를 사용하여 환경변수를 출력할 수 있고, 환경변수를 사용하여 요청의 특징에 따라 흐름제어 요소로 페이지의 일부를 변경할 수 있다. 아파치는 또 SSI 문서에게 위에서 설명한 표준 CGI 환경변수를 제공한다. 더 자세한 내용은 SSI 투토리얼을 참고하라.

### 접근제어

`allow from env=`과 `deny from env=` 지시어를 사용하여 환경변수 값에 따라 서버로의 접근을 조절할 수 있다. `SetEnvIf`와 같이 사용하면 클라이언트의 특징에 따라 자유롭게 서버로의 접근을 제어할 수 있다. 예를 들어, 특정 브라우저의 (User-Agent) 접근을 거부할 수 있다.

### 조건부 로그

`LogFormat`의 `%e` 옵션을 사용하여 환경변수를 접근 로그에 기록할 수 있다. 또, `CustomLog` 지시어의 조건부 형식을 사용하면 환경변수의 상황에 따라 요청을 로그할지 여부를 결정할 수 있다. `SetEnvIf`와 같이 사용하여 어떤 요청을 로그할지 자유롭게 결정할 수 있다. 예를 들어, 파일명이 `gif`로 끝나는 요청은 로그하지 않거나, 외부 네트웍에 있는 클라이언트의 요청만을 로그할 수 있다.

### 조건부 응답 헤더

`Header` 지시어는 클라이언트에게 응답을 보낼때 환경변수의 유무에 따라 어떤 HTTP 헤더를 포함할지 결정할 수 있다. 예를 들어, 클라이언트의 요청에 특정 헤더가 있는 경우에만 어떤 응답 헤더를 보낼 수 있다.

### 외부 필터 실행하기

`mod_ext_filter`의 `ExtFilterDefine` 지시어로 설정한 외부 필터를 `disableenv=`와 `enableenv=` 옵션을 사용하여 환경변수에 따라 선택적으로 실행할 수 있다.

### URL 재작성(Rewriting)

`RewriteCond`의 TestString에 `%{ENV:...}` 형식을 사용하면 mod_rewrite의 재작성 엔진이 환경변수에 따라 다르게 행동한다. mod_rewrite에서 앞에 `ENV:`를 붙이지않고 접근하는 변수는 실제 환경변수가 아님을 주의하라. 그들은 다른 모듈에서 읽을 수 없는 mod_rewrite에 한정된 변수다.

## 특별한 목적의 환경변수

클라이언트와 원활한 동작하기위해 아파치는 특별한 클라이언트에 대해 자신의 행동을 수정한다. 보통 `BrowserMatch`에서 환경변수를 정의하여 이런 문제를 해결한다. 그러나 `SetEnv`와 `PassEnv`로도 가능하다.

### downgrade-1.0

요청이 이후 버전을 사용하더라도 HTTP/1.0 요청으로 처리한다.

### force-gzip

`DEFLATE` 필터를 사용할때 이 환경변수는 브라우저의 accept-encoding 설정을 무시하고 무조건 압축된 결과를 보낸다.

### force-no-vary

응답을 클라이언트에게 보내기 전에 응답 헤더에서 `Vary` 필드를 뺀다. 어떤 클라이언트는 이 필드를 제대로 해석하지 못한다. 이 변수는 이런 문제를 해결한다. 또한, 이 변수는 force-response-1.0을 가정한다.

### force-response-1.0

HTTP/1.0 요청을 하는 클라이언트에게 HTTP/1.0 응답을 강제한다. 원래 AOL 프록시에 문제가 있어서 만들어졌다. 어떤 HTTP/1.0 클라이언트는 HTTP/1.1 응답을 받으면 제대로 동작하지 않으므로, 이 문제를 해결하기위해 사용한다.

### gzip-only-text/html

값이 "1"이면 `text/html`이 아닌 content-type에 대해 `mod_deflate`의 DEFLATE 출력필터를 사용하지 않는다. (gzip 뿐만 아니라 "identity"가 아닌 모든 인코딩의) 정적으로 압축한 파일의 경우에도 `mod_negotiation`은 이 변수를 참고한다.

### no-gzip

이 옵션을 설정하면 `mod_deflate`의 `DEFLATE` 필터를 사용하지 않고, `mod_negotiation`은 인코딩된 자원을 보내지 않는다.

### nokeepalive

`KeepAlive`를 무시한다.

### prefer-language

이 변수는 `mod_negotiation`의 행동에 영향을 미친다. 변수가 (`en`, `ja`, `x-klingon` 등) 언어태그를 담고있다면, `mod_negotiation`는 그 언어로 된 변형을 보내길 시도한다. 그런 변형이 없다면 일반적인 협상 과정을 시작한다.

### redirect-carefully

서버가 더 조심히 클라이언트에게 리다이렉션을 보낸다. 보통 리다이렉션을 처리하는데 문제가 있는 클라이언트을 위해 사용한다. 원래 Microsoft의 WebFolders 소프트웨어가 DAV 메써드를 통해 디렉토리 자원의 리다이렉션을 처리하는데 문제가 있어서 만들어졌다.

### suppress-error-charset

2.0.40 이후 버전에 있다

아파치가 클라이언트의 요청에 대한 응답으로 리다이렉션을 보낼때 클라이언트가 자동으로 리다이렉션을 따라가지 못하는(혹은 않는) 경우에 대비하여 응답에 사용자에게 보여줄 문구를 포함한다. 아파치는 보통 이 글을 아파치가 사용하는 문자집합인 ISO-8859-1로 표시한다.

그러나 리다이렉션된 페이지가 다른 문자집합을 사용할 경우 어떤 이상한 브라우저 버전은 실제 페이지가 아니라 리다이렉션 페이지의 문자집합을 사용하려고 한다. 예를 들어, 그리스어가 이상하게 보일 수 있다.

이 환경변수는 아파치가 리다이렉션 페이지에 문자집합을 설정하지않도록 하여, 이런 브라우저가 실제 페이지의 문자집합을 올바로 사용하게 만든다.

## 예제

### 잘못 동작하는 클라이언트들을 위해 프로토콜 행동 변경하기

클라이언트들의 이미 알려진 문제를 해결하기위해 httpd.conf에 다음 내용을 포함하길 바란다.

    #
    # 다음 지시어들은 일반적인 HTTP 응답을 변경한다.
    # 첫번째 지시어는 Netscape 2.x와 이를 가장한 브라우저에게
    # keepalive를 사용하지 않는다. 이들 브라우저 구현에 문제가 있다.
    # 두번째 지시어는 HTTP/1.1 구현이 잘못되었고 301이나 302
    # (리다이렉션) 응답에 사용한 keepalive를 제대로 지원하지
    # 못하는 Microsoft Internet Explorer 4.0b2를 위한 것이다.
    #
    BrowserMatch "Mozilla/2" nokeepalive
    BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0

    #
    # 다음 지시어는 기본적인 HTTP/1.1 응답을 이해하지 못하여
    # HTTP/1.0 규약을 어기는 브라우저에게 HTTP/1.1 응답을 보내지 않는다.
    #
    BrowserMatch "RealPlayer 4\.0" force-response-1.0
    BrowserMatch "Java/1\.0" force-response-1.0
    BrowserMatch "JDK/1\.0" force-response-1.0

### 접근 로그에 이미지에 대한 요청을 로그하지 않기

이 예제는 이미지에 대한 요청을 접근 로그에 기록하지 않는다. 특정 디렉토리에 대한 혹은 특정 호스트에서 온 요청을 로그하지 않도록 쉽게 수정할 수 있다.

    SetEnvIf Request_URI \.gif image-request
    SetEnvIf Request_URI \.jpg image-request
    SetEnvIf Request_URI \.png image-request
    CustomLog logs/access_log common env=!image-request

### "이미지 도둑" 방지

이 예는 현재 서버외의 사용자가 페이지에 서버에 있는 이미지를 포함하지 못하도록 하는 방법을 설명한다. 이 설정을 권장하지는 않으며, 제한된 경우에만 동작한다. 우리는 모든 이미지가 /web/images 디렉토리 안에 있다고 가정한다.

    SetEnvIf Referer "^http://www.example.com/" local_referal
    # Referer 정보를 보내지 않는 브라우저를 허용한다
    SetEnvIf Referer "^$" local_referal
    <Directory /web/images>
       Order Deny,Allow
       Deny from all
       Allow from env=local_referal
    </Directory>

이 기법에 대한 자세한 설명은 ApacheToday 투토리얼 " Keeping Your Images from Adorning Other Sites"를 참고하라.

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

## Comments

Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.