Apache HTTP Server Version 2.2
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.
웹마스터는 오류나 문제가 발생했을때 아파치의 응답을 설정할 수 있다.
서버가 오류나 문제를 발견했을때 보낼 사용자정의 응답을 정의할 수 있다.
스크립트가 죽은 경우 "500 Server Error" 응답 대신 사용자에게 더 친근한 문구를 사용하거나 다른 (같은 사이트나 외부 사이트의) URL로 리다이렉션을 할 수 있다.
NCSA httpd 1.3은 사용자에게 무의미하고 지루한 오류문을 보냈다. 문제가 발생한 이유를 로그에 남길 수도 없었다.
서버는 다음과 같은 일을 할 수 있다:
다른 사이트의 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은,
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:
헤더가 아무 소용없게 될 수 있다.