사용자정의 오류 응답 - 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 | es | ja | ko | tr

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

웹마스터는 오류나 문제가 발생했을때 아파치의 응답을 설정할 수 있다.

서버가 오류나 문제를 발견했을때 보낼 사용자정의 응답을 정의할 수 있다.

스크립트가 죽은 경우 "500 Server Error" 응답 대신 사용자에게 더 친근한 문구를 사용하거나 다른 (같은 사이트나 외부 사이트의) URL로 리다이렉션을 할 수 있다.

- Comments

## 행동

### 이전 행동

NCSA httpd 1.3은 사용자에게 무의미하고 지루한 오류문을 보냈다. 문제가 발생한 이유를 로그에 남길 수도 없었다.

### 새로운 행동

서버는 다음과 같은 일을 할 수 있다:

1. NCSA의 고정된 문구 대신 다른 문구를 보여주거나
2. 같은 사이트의 URL로 리다이렉션하거나
3. 외부 사이트의 URL로 리다이렉션한다.

다른 사이트의 URL로 리다이렉션하는 것이 유용할 수 있지만, 이 경우 문제를 설명하거나 로그하는데 필요한 정보중 일부만 전달된다.

오류에 대한 정보를 전달하기위해 아파치는 CGI식의 새로운 환경변수를 정의한다:

`REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap, image/jpeg
REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX A.09.05 9000/712)
REDIRECT_PATH=.:/bin:/usr/local/bin:/etc
REDIRECT_QUERY_STRING=
REDIRECT_REMOTE_ADDR=121.345.78.123
REDIRECT_REMOTE_HOST=ooh.ahhh.com
REDIRECT_SERVER_NAME=crash.bang.edu
REDIRECT_SERVER_PORT=80
REDIRECT_SERVER_SOFTWARE=Apache/0.8.15
REDIRECT_URL=/cgi-bin/buggy.pl`

`REDIRECT_` 접두사에 주목하라.

최소한 `REDIRECT_URL`과 `REDIRECT_QUERY_STRING`은 (cgi-script나 cgi-include일) 새 URL로 넘겨진다. 다른 변수는 오류가 발생하기 이전에 (역주; 이름에서 `REDIRECT_`를 뺀 환경변수가) 존재한 경우에만 있다. `ErrorDocument`가 외부로 (같은 서버라도 `http:`와 같은 스킴(scheme)으로 시작한다면) 리다이렉션한다면 이중 어떤 것도 설정되지 않는다.

## 설정

`AllowOverride`가 적절히 설정되었다면 .htaccess 파일에서 `ErrorDocument`를 사용할 수 있다.

다음은 예이다...

`ErrorDocument 500 /cgi-bin/crash-recover
ErrorDocument 500 "Sorry, our script crashed. Oh dear"
ErrorDocument 500 http://xxx/
ErrorDocument 404 /Lame_excuses/not_found.html
ErrorDocument 401 /Subscription/how_to_subscribe.html`

문법은,

`ErrorDocument <3-digit-code> <action>`

가능한 action은,

1. 출력할 문구. 따옴표 (")를 문구 앞에 붙인다. 뒤에 나오는 따옴표는 출력된다. 주의: 앞에 붙은 따옴표 (")는 출력되지 않는다.
2. 리다이렉션할 외부 URL.
3. 리다이렉션할 내부 URL.

## 사용자정의 오류 응답과 리다이렉션

URL로 리다이렉션하는 아파치 행동은 스크립트/server-include에 환경변수를 더 넘겨주도록 변경되었다.

### 이전 행동

리다이렉션되는 스크립트에 표준 CGI 변수들이 넘어간다. 어디에서 리다이렉션이 일어났는지 알 수 없다.

### 새로운 행동

리다이렉션된 스크립트는 새로운 환경변수들을 사용할 수 있다. 모두 앞에 `REDIRECT_`가 붙어있다. `REDIRECT_` 환경변수는 원래 CGI 환경변수명 앞에 `REDIRECT_`를 붙여서 만든다. 예를 들어, `HTTP_USER_AGENT`는 `REDIRECT_HTTP_USER_AGENT`가 되었다. 이런 변수에 추가로 스크립트가 원래 URL을 알도록 아파치는 `REDIRECT_URL`과 `REDIRECT_STATUS`를 정의한다. 원래 URL과 리다이렉션된 URL 모두 접근 로그에 기록할 수 있다.

ErrorDocument가 같은 서버에 있는 CGI 스크립트로 리다이렉션한다면, 스크립트는 클라이언트에게 오류 상황을 확실히 전달하기위해 출력에 "`Status:`" 헤더 필드를 포함해야 한다. 예를 들어, Perl로 작성한 ErrorDocument 스크립트는 다음과 같다:

`...
print "Content-type: text/html\n";
printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"};
...`

`404 Not Found`와 같은 특정 오류 상황에 대한 스크립트라면, 대신 (역주; 고정된) 특정 상태코드와 오류문을 사용할 수 있다.

(클라이언트에게 리다이렉션을 요청하기위해) 응답에 `Location:` 헤더를 포함한다면, 스크립트는 반드시 (`302 Found` 같은) 적절한 `Status:` 헤더를 출력해야 함을 주의하라. 그렇지않으면 `Location:` 헤더가 아무 소용없게 될 수 있다.

가능한 언어: en | es | 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.