1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
|
<?xml version="1.0" encoding="EUC-KR"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>사용자정의 오류 응답 - Apache HTTP Server</title>
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="./images/favicon.ico" rel="shortcut icon" /><link href="http://httpd.apache.org/docs/current/custom-error.html" rel="canonical" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">모듈</a> | <a href="./mod/directives.html">지시어들</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">용어</a> | <a href="./sitemap.html">사이트맵</a></p>
<p class="apache">Apache HTTP Server Version 2.0</p>
<img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.0</a></div><div id="page-content"><div class="retired"><h4>Please note</h4>
<p>This document refers to the <strong>2.0</strong> version of Apache httpd, which <strong>is no longer maintained</strong>. Upgrade, and refer to the current version of httpd instead, documented at:</p>
<ul><li><a href="http://httpd.apache.org/docs/current/">Current release version of Apache HTTP Server documentation</a></li></ul><p>You may follow <a href="http://httpd.apache.org/docs/current/custom-error.html">this link</a> to go to the current version of this document.</p></div><div id="preamble"><h1>사용자정의 오류 응답</h1>
<div class="toplang">
<p><span>가능한 언어: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>웹마스터는 오류나 문제가 발생했을때 아파치의 응답을
설정할 수 있다.</p>
<p>서버가 오류나 문제를 발견했을때 보낼 사용자정의 응답을
정의할 수 있다.</p>
<p>스크립트가 죽은 경우 "500 Server Error" 응답 대신 사용자에게
더 친근한 문구를 사용하거나 다른 (같은 사이트나 외부 사이트의)
URL로 리다이렉션을 할 수 있다.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#behavior">행동</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configuration">설정</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#custom">사용자정의 오류 응답과 리다이렉션</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="behavior" id="behavior">행동</a></h2>
<h3>이전 행동</h3>
<p>NCSA httpd 1.3은 사용자에게 무의미하고 지루한 오류문을
보냈다. 문제가 발생한 이유를 로그에 남길 수도 없었다.</p>
<h3>새로운 행동</h3>
<p>서버는 다음과 같은 일을 할 수 있다:</p>
<ol>
<li>NCSA의 고정된 문구 대신 다른 문구를 보여주거나</li>
<li>같은 사이트의 URL로 리다이렉션하거나</li>
<li>외부 사이트의 URL로 리다이렉션한다.</li>
</ol>
<p>다른 사이트의 URL로 리다이렉션하는 것이 유용할 수 있지만,
이 경우 문제를 설명하거나 로그하는데 필요한 정보중 일부만
전달된다.</p>
<p>오류에 대한 정보를 전달하기위해 아파치는 CGI식의 새로운
환경변수를 정의한다:</p>
<div class="example"><p><code>
REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap,
image/jpeg<br />
REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX A.09.05
9000/712)<br />
REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br />
REDIRECT_QUERY_STRING=<br />
REDIRECT_REMOTE_ADDR=121.345.78.123<br />
REDIRECT_REMOTE_HOST=ooh.ahhh.com<br />
REDIRECT_SERVER_NAME=crash.bang.edu<br />
REDIRECT_SERVER_PORT=80<br />
REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br />
REDIRECT_URL=/cgi-bin/buggy.pl
</code></p></div>
<p><code>REDIRECT_</code> 접두사에 주목하라.</p>
<p>최소한 <code>REDIRECT_URL</code>과
<code>REDIRECT_QUERY_STRING</code>은 (cgi-script나
cgi-include일) 새 URL로 넘겨진다. 다른 변수는 오류가
발생하기 이전에 <span class="transnote">(<em>역주;</em> 이름에서 <code>REDIRECT_</code>를
뺀 환경변수가)</span> 존재한 경우에만 있다.
<code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>가
<em>외부로</em> (같은 서버라도 <code>http:</code>와
같은 스킴(scheme)으로 시작한다면) 리다이렉션한다면
이중 어떤 것도 설정되지 <strong>않는다</strong>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuration" id="configuration">설정</a></h2>
<p><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>가
적절히 설정되었다면 .htaccess 파일에서
<code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>를 사용할
수 있다.</p>
<p>다음은 예이다...</p>
<div class="example"><p><code>
ErrorDocument 500 /cgi-bin/crash-recover <br />
ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br />
ErrorDocument 500 http://xxx/ <br />
ErrorDocument 404 /Lame_excuses/not_found.html <br />
ErrorDocument 401 /Subscription/how_to_subscribe.html
</code></p></div>
<p>문법은,</p>
<div class="example"><p><code>
ErrorDocument <3-digit-code> <action>
</code></p></div>
<p>가능한 action은,</p>
<ol>
<li>출력할 문구. 따옴표 (")를 문구 앞에 붙인다. 뒤에 나오는
따옴표는 출력된다. <em>주의: 앞에 붙은 따옴표 (")는 출력되지
않는다.</em></li>
<li>리다이렉션할 외부 URL.</li>
<li>리다이렉션할 내부 URL.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="custom" id="custom">사용자정의 오류 응답과 리다이렉션</a></h2>
<p>URL로 리다이렉션하는 아파치 행동은
스크립트/server-include에 환경변수를 더 넘겨주도록 변경되었다.</p>
<h3>이전 행동</h3>
<p>리다이렉션되는 스크립트에 표준 CGI 변수들이 넘어간다.
어디에서 리다이렉션이 일어났는지 알 수 없다.</p>
<h3>새로운 행동</h3>
<p>리다이렉션된 스크립트는 새로운 환경변수들을 사용할
수 있다. 모두 앞에 <code>REDIRECT_</code>가 붙어있다.
<code>REDIRECT_</code> 환경변수는 원래 CGI 환경변수명
앞에 <code>REDIRECT_</code>를 붙여서 만든다. <em>예를
들어</em>, <code>HTTP_USER_AGENT</code>는
<code>REDIRECT_HTTP_USER_AGENT</code>가 되었다. 이런 변수에
추가로 스크립트가 원래 URL을 알도록 아파치는
<code>REDIRECT_URL</code>과 <code>REDIRECT_STATUS</code>를
정의한다. 원래 URL과 리다이렉션된 URL 모두 접근 로그에
기록할 수 있다.</p>
<p>ErrorDocument가 같은 서버에 있는 CGI 스크립트로
리다이렉션한다면, 스크립트는 클라이언트에게 오류 상황을
확실히 전달하기위해 출력에 "<code>Status:</code>" 헤더
필드를 포함해야 한다. 예를 들어, Perl로 작성한 ErrorDocument
스크립트는 다음과 같다:</p>
<div class="example"><p><code>
... <br />
print "Content-type: text/html\n"; <br />
printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
...
</code></p></div>
<p><code>404 Not Found</code>와 같은 특정 오류
상황에 대한 스크립트라면, 대신 <span class="transnote">(<em>역주;</em> 고정된)</span>
특정 상태코드와 오류문을 사용할 수 있다.</p>
<p>(클라이언트에게 리다이렉션을 요청하기위해) 응답에
<code>Location:</code> 헤더를 포함한다면, 스크립트는
<em>반드시</em> (<code>302 Found</code> 같은) 적절한
<code>Status:</code> 헤더를 출력해야 함을 주의하라. 그렇지않으면
<code>Location:</code> 헤더가 아무 소용없게 될 수 있다.</p>
</div></div>
<div class="bottomlang">
<p><span>가능한 언어: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">모듈</a> | <a href="./mod/directives.html">지시어들</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">용어</a> | <a href="./sitemap.html">사이트맵</a></p></div>
</body></html>
|
