<-
Apache > HTTP Server > Documentation > Version 2.0

Please note

This document refers to the 2.0 version of Apache httpd, which is no longer maintained. Upgrade, and refer to the current version of httpd instead, documented at:

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

사용자정의 오류 응답

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

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

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

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

top

행동

이전 행동

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

top

설정

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.
top

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

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

이전 행동

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

새로운 행동

리다이렉션된 스크립트는 새로운 환경변수들을 사용할 수 있다. 모두 앞에 REDIRECT_가 붙어있다. REDIRECT_ 환경변수는 원래 CGI 환경변수명 앞에 REDIRECT_를 붙여서 만든다. 예를 들어, HTTP_USER_AGENTREDIRECT_HTTP_USER_AGENT가 되었다. 이런 변수에 추가로 스크립트가 원래 URL을 알도록 아파치는 REDIRECT_URLREDIRECT_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  |  fr  |  ja  |  ko  |  tr