Gecko [ www.jdcpatala.org ]

Name	Size	Permission
developer	[ DIR ]	drwxr-xr-x
faq	[ DIR ]	drwxr-xr-x
howto	[ DIR ]	drwxr-xr-x
images	[ DIR ]	drwxr-xr-x
misc	[ DIR ]	drwxr-xr-x
mod	[ DIR ]	drwxr-xr-x
platform	[ DIR ]	drwxr-xr-x
programs	[ DIR ]	drwxr-xr-x
rewrite	[ DIR ]	drwxr-xr-x
ssl	[ DIR ]	drwxr-xr-x
style	[ DIR ]	drwxr-xr-x
vhosts	[ DIR ]	drwxr-xr-x
BUILDING	102 B	-rw-r--r--
LICENSE	11.09 KB	-rw-r--r--
bind.html	538 B	-rw-r--r--
bind.html.de	15.28 KB	-rw-r--r--
bind.html.en	15.19 KB	-rw-r--r--
bind.html.fr.utf8	16.49 KB	-rw-r--r--
bind.html.ja.utf8	14.34 KB	-rw-r--r--
bind.html.ko.euc-kr	10.95 KB	-rw-r--r--
bind.html.tr.utf8	16.21 KB	-rw-r--r--
caching.html	292 B	-rw-r--r--
caching.html.en	50.66 KB	-rw-r--r--
caching.html.fr.utf8	56.43 KB	-rw-r--r--
caching.html.tr.utf8	54.69 KB	-rw-r--r--
configuring.html	580 B	-rw-r--r--
configuring.html.de	16.71 KB	-rw-r--r--
configuring.html.en	17.36 KB	-rw-r--r--
configuring.html.fr.utf8	18.84 KB	-rw-r--r--
configuring.html.ja.utf8	16.98 KB	-rw-r--r--
configuring.html.ko.euc-kr	13.71 KB	-rw-r--r--
configuring.html.tr.utf8	18.57 KB	-rw-r--r--
content-negotiation.html	529 B	-rw-r--r--
content-negotiation.html.en	33.75 KB	-rw-r--r--
content-negotiation.html.fr.ut...	38.73 KB	-rw-r--r--
content-negotiation.html.ja.ut...	40.97 KB	-rw-r--r--
content-negotiation.html.ko.eu...	28.48 KB	-rw-r--r--
content-negotiation.html.tr.ut...	37.08 KB	-rw-r--r--
convenience.map	36.73 KB	-rw-r--r--
custom-error.html	586 B	-rw-r--r--
custom-error.html.en	13.58 KB	-rw-r--r--
custom-error.html.es	13.3 KB	-rw-r--r--
custom-error.html.fr.utf8	14.51 KB	-rw-r--r--
custom-error.html.ja.utf8	13.21 KB	-rw-r--r--
custom-error.html.ko.euc-kr	11.52 KB	-rw-r--r--
custom-error.html.tr.utf8	14.17 KB	-rw-r--r--
dns-caveats.html	489 B	-rw-r--r--
dns-caveats.html.en	12.37 KB	-rw-r--r--
dns-caveats.html.fr.utf8	13.39 KB	-rw-r--r--
dns-caveats.html.ja.utf8	17.37 KB	-rw-r--r--
dns-caveats.html.ko.euc-kr	13.47 KB	-rw-r--r--
dns-caveats.html.tr.utf8	12.79 KB	-rw-r--r--
dso.html	449 B	-rw-r--r--
dso.html.en	19.27 KB	-rw-r--r--
dso.html.fr.utf8	22.21 KB	-rw-r--r--
dso.html.ja.utf8	23.28 KB	-rw-r--r--
dso.html.ko.euc-kr	16.59 KB	-rw-r--r--
dso.html.tr.utf8	21.48 KB	-rw-r--r--
env.html	449 B	-rw-r--r--
env.html.en	30.62 KB	-rw-r--r--
env.html.fr.utf8	33.06 KB	-rw-r--r--
env.html.ja.utf8	30.56 KB	-rw-r--r--
env.html.ko.euc-kr	22.14 KB	-rw-r--r--
env.html.tr.utf8	32.71 KB	-rw-r--r--
expr.html	199 B	-rw-r--r--
expr.html.en	36.03 KB	-rw-r--r--
expr.html.fr.utf8	38.48 KB	-rw-r--r--
filter.html	550 B	-rw-r--r--
filter.html.en	14.84 KB	-rw-r--r--
filter.html.es	17.28 KB	-rw-r--r--
filter.html.fr.utf8	16.01 KB	-rw-r--r--
filter.html.ja.utf8	9.23 KB	-rw-r--r--
filter.html.ko.euc-kr	8.37 KB	-rw-r--r--
filter.html.tr.utf8	16 KB	-rw-r--r--
getting-started.html	316 B	-rw-r--r--
getting-started.html.en	15.22 KB	-rw-r--r--
getting-started.html.fr.utf8	17.18 KB	-rw-r--r--
getting-started.html.ru.utf8	21.27 KB	-rw-r--r--
glossary.html	650 B	-rw-r--r--
glossary.html.de	34.8 KB	-rw-r--r--
glossary.html.en	30.02 KB	-rw-r--r--
glossary.html.es	31.97 KB	-rw-r--r--
glossary.html.fr.utf8	34.01 KB	-rw-r--r--
glossary.html.ja.utf8	32.03 KB	-rw-r--r--
glossary.html.ko.euc-kr	20.88 KB	-rw-r--r--
glossary.html.tr.utf8	33.11 KB	-rw-r--r--
handler.html	649 B	-rw-r--r--
handler.html.en	11.79 KB	-rw-r--r--
handler.html.es	12.72 KB	-rw-r--r--
handler.html.fr.utf8	12.6 KB	-rw-r--r--
handler.html.ja.utf8	13.36 KB	-rw-r--r--
handler.html.ko.euc-kr	11.35 KB	-rw-r--r--
handler.html.tr.utf8	12.39 KB	-rw-r--r--
handler.html.zh-cn.utf8	11.34 KB	-rw-r--r--
index.html	981 B	-rw-r--r--
index.html.da	8.85 KB	-rw-r--r--
index.html.de	9.28 KB	-rw-r--r--
index.html.en	9.11 KB	-rw-r--r--
index.html.es	9.75 KB	-rw-r--r--
index.html.fr.utf8	9.47 KB	-rw-r--r--
index.html.ja.utf8	9.55 KB	-rw-r--r--
index.html.ko.euc-kr	8.23 KB	-rw-r--r--
index.html.pt-br	9.26 KB	-rw-r--r--
index.html.ru.utf8	10.41 KB	-rw-r--r--
index.html.tr.utf8	9.34 KB	-rw-r--r--
index.html.zh-cn.utf8	8.85 KB	-rw-r--r--
install.html	643 B	-rw-r--r--
install.html.de	25.56 KB	-rw-r--r--
install.html.en	26.97 KB	-rw-r--r--
install.html.es	29.38 KB	-rw-r--r--
install.html.fr.utf8	29.42 KB	-rw-r--r--
install.html.ja.utf8	27.58 KB	-rw-r--r--
install.html.ko.euc-kr	19.83 KB	-rw-r--r--
install.html.tr.utf8	29.06 KB	-rw-r--r--
invoking.html	650 B	-rw-r--r--
invoking.html.de	13.91 KB	-rw-r--r--
invoking.html.en	12.55 KB	-rw-r--r--
invoking.html.es	13.9 KB	-rw-r--r--
invoking.html.fr.utf8	13.42 KB	-rw-r--r--
invoking.html.ja.utf8	14.04 KB	-rw-r--r--
invoking.html.ko.euc-kr	10.87 KB	-rw-r--r--
invoking.html.tr.utf8	13.39 KB	-rw-r--r--
license.html	118 B	-rw-r--r--
license.html.en	15.49 KB	-rw-r--r--
logs.html	454 B	-rw-r--r--
logs.html.en	39.03 KB	-rw-r--r--
logs.html.fr.utf8	44.23 KB	-rw-r--r--
logs.html.ja.utf8	40.13 KB	-rw-r--r--
logs.html.ko.euc-kr	29.03 KB	-rw-r--r--
logs.html.tr.utf8	42.61 KB	-rw-r--r--
mpm.html	704 B	-rw-r--r--
mpm.html.de	11.13 KB	-rw-r--r--
mpm.html.en	13.26 KB	-rw-r--r--
mpm.html.es	10.46 KB	-rw-r--r--
mpm.html.fr.utf8	14.37 KB	-rw-r--r--
mpm.html.ja.utf8	11.7 KB	-rw-r--r--
mpm.html.ko.euc-kr	9.77 KB	-rw-r--r--
mpm.html.tr.utf8	14.19 KB	-rw-r--r--
mpm.html.zh-cn.utf8	11.26 KB	-rw-r--r--
new_features_2_0.html	712 B	-rw-r--r--
new_features_2_0.html.de	17.67 KB	-rw-r--r--
new_features_2_0.html.en	15.55 KB	-rw-r--r--
new_features_2_0.html.fr.utf8	18.27 KB	-rw-r--r--
new_features_2_0.html.ja.utf8	18.56 KB	-rw-r--r--
new_features_2_0.html.ko.euc-k...	14.52 KB	-rw-r--r--
new_features_2_0.html.pt-br	17.4 KB	-rw-r--r--
new_features_2_0.html.tr.utf8	17.37 KB	-rw-r--r--
new_features_2_2.html	520 B	-rw-r--r--
new_features_2_2.html.en	18.58 KB	-rw-r--r--
new_features_2_2.html.fr.utf8	20.73 KB	-rw-r--r--
new_features_2_2.html.ko.euc-k...	9.46 KB	-rw-r--r--
new_features_2_2.html.pt-br	10.81 KB	-rw-r--r--
new_features_2_2.html.tr.utf8	20.42 KB	-rw-r--r--
new_features_2_4.html	319 B	-rw-r--r--
new_features_2_4.html.en	28.17 KB	-rw-r--r--
new_features_2_4.html.fr.utf8	31.61 KB	-rw-r--r--
new_features_2_4.html.tr.utf8	30.66 KB	-rw-r--r--
sections.html	474 B	-rw-r--r--
sections.html.en	37.51 KB	-rw-r--r--
sections.html.fr.utf8	41.64 KB	-rw-r--r--
sections.html.ja.utf8	32.81 KB	-rw-r--r--
sections.html.ko.euc-kr	25.12 KB	-rw-r--r--
sections.html.tr.utf8	41.4 KB	-rw-r--r--
server-wide.html	489 B	-rw-r--r--
server-wide.html.en	11.88 KB	-rw-r--r--
server-wide.html.fr.utf8	12.41 KB	-rw-r--r--
server-wide.html.ja.utf8	12.02 KB	-rw-r--r--
server-wide.html.ko.euc-kr	10.41 KB	-rw-r--r--
server-wide.html.tr.utf8	12.4 KB	-rw-r--r--
sitemap.html	736 B	-rw-r--r--
sitemap.html.de	26.2 KB	-rw-r--r--
sitemap.html.en	25.95 KB	-rw-r--r--
sitemap.html.es	25.86 KB	-rw-r--r--
sitemap.html.fr.utf8	27.01 KB	-rw-r--r--
sitemap.html.ja.utf8	26.42 KB	-rw-r--r--
sitemap.html.ko.euc-kr	23.11 KB	-rw-r--r--
sitemap.html.tr.utf8	26.88 KB	-rw-r--r--
sitemap.html.zh-cn.utf8	23.98 KB	-rw-r--r--
socache.html	205 B	-rw-r--r--
socache.html.en	9.54 KB	-rw-r--r--
socache.html.fr.utf8	10.23 KB	-rw-r--r--
stopping.html	650 B	-rw-r--r--
stopping.html.de	19.53 KB	-rw-r--r--
stopping.html.en	17.4 KB	-rw-r--r--
stopping.html.es	19.32 KB	-rw-r--r--
stopping.html.fr.utf8	19.67 KB	-rw-r--r--
stopping.html.ja.utf8	19.98 KB	-rw-r--r--
stopping.html.ko.euc-kr	14.67 KB	-rw-r--r--
stopping.html.tr.utf8	19.55 KB	-rw-r--r--
suexec.html	464 B	-rw-r--r--
suexec.html.en	28.56 KB	-rw-r--r--
suexec.html.fr.utf8	32.24 KB	-rw-r--r--
suexec.html.ja.utf8	33.21 KB	-rw-r--r--
suexec.html.ko.euc-kr	24.09 KB	-rw-r--r--
suexec.html.tr.utf8	31.05 KB	-rw-r--r--
upgrading.html	209 B	-rw-r--r--
upgrading.html.en	29.98 KB	-rw-r--r--
upgrading.html.fr.utf8	33.4 KB	-rw-r--r--
urlmapping.html	484 B	-rw-r--r--
urlmapping.html.en	26.02 KB	-rw-r--r--
urlmapping.html.fr.utf8	28.39 KB	-rw-r--r--
urlmapping.html.ja.utf8	25.7 KB	-rw-r--r--
urlmapping.html.ko.euc-kr	19.33 KB	-rw-r--r--
urlmapping.html.tr.utf8	27.96 KB	-rw-r--r--

Code Editor : custom-error.html.en

<?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />

<title>Custom Error Responses - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>

<p>Although the Apache HTTP Server provides generic error responses
    in the event of 4xx or 5xx HTTP status codes, these responses are
    rather stark, uninformative, and can be intimidating to site users.
    You may wish to provide custom error responses which are either
    friendlier, or in some language other than English, or perhaps which
    are styled more in line with your site layout.</p>

<p>Customized error responses can be defined for any HTTP status
    code designated as an error condition - that is, any 4xx or 5xx
    status.</p>

<p>Additionally, a set of values are provided, so
    that the error document can be customized further based on the
    values of these variables, using <a href="howto/ssi.html">Server
    Side Includes</a>. Or, you can have error conditions handled by a
    cgi program, or other dynamic handler (PHP, mod_perl, etc) which
    makes use of these variables.</p>

</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#configuration">Configuration</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#variables">Available Variables</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#custom">Customizing Error Responses</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#multi-lang">Multi Language Custom Error Documents</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="configuration" id="configuration">Configuration</a></h2>

<p>Custom error documents are configured using the <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> directive,
    which may be used in global,
    virtualhost, or directory context. It may be used in .htaccess files
    if <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> is set to
    FileInfo.</p>

<pre class="prettyprint lang-config">ErrorDocument 500 "Sorry, our script crashed. Oh dear"
ErrorDocument 500 /cgi-bin/crash-recover
ErrorDocument 500 http://error.example.com/server_error.html
ErrorDocument 404 /errors/not_found.html
ErrorDocument 401 /subscription/how_to_subscribe.html</pre>

<p>The syntax of the <code>ErrorDocument</code> directive is:</p>

<pre class="prettyprint lang-config">ErrorDocument &lt;3-digit-code&gt; &lt;action&gt;</pre>

<p>where the action will be treated as:</p>

<ol>
      <li>A local URL to redirect to (if the action begins with a "/").</li>
      <li>An external URL to redirect to (if the action is a valid URL).</li>
      <li>Text to be displayed (if none of the above). The text must be
          wrapped in quotes (") if it consists of more than one word.</li>
    </ol>

<p>When redirecting to a local URL, additional environment variables
    are set so that the response can be further customized. They are not sent to
    external URLs.</p>

</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="variables" id="variables">Available Variables</a></h2>

<p>Redirecting to another URL can be useful, but only if some
      information can be passed which can then be used to explain or log
      the error condition more clearly.</p>

<p>To achieve this, when the error redirect is sent, additional
      environment variables will be set, which will be generated from
      the headers provided to the original request by prepending
      'REDIRECT_' onto the original header name. This provides the error
      document the context of the original request.</p>

<p>For example, you might receive, in addition to more usual
      environment variables, the following.</p>

<div class="example"><p><code>
        REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/jpeg, image/png<br />
        REDIRECT_HTTP_USER_AGENT=Mozilla/5.0 Fedora/3.5.8-1.fc12 Firefox/3.5.8<br />
        REDIRECT_PATH=.:/bin:/usr/local/bin:/sbin<br />
        REDIRECT_QUERY_STRING=<br />
        REDIRECT_REMOTE_ADDR=121.345.78.123<br />
        REDIRECT_REMOTE_HOST=client.example.com<br />
        REDIRECT_SERVER_NAME=www.example.edu<br />
        REDIRECT_SERVER_PORT=80<br />
        REDIRECT_SERVER_SOFTWARE=Apache/2.2.15<br />
        REDIRECT_URL=/cgi-bin/buggy.pl
      </code></p></div>

<p><code>REDIRECT_</code> environment variables are created from
      the environment variables which existed prior to the
      redirect. They are renamed with a <code>REDIRECT_</code>
      prefix, <em>i.e.</em>, <code>HTTP_USER_AGENT</code> becomes
      <code>REDIRECT_HTTP_USER_AGENT</code>.</p>

<p><code>REDIRECT_URL</code>, <code>REDIRECT_STATUS</code>, and
      <code>REDIRECT_QUERY_STRING</code> are guaranteed to be set, and
      the other headers will be set only if they existed prior to the
      error condition.</p>

<p><strong>None</strong> of these will be
      set if the <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> target is an
      <em>external</em> redirect (anything starting with a
      scheme name like <code>http:</code>, even if it refers to the same host
      as the server).</p>
  </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">Customizing Error Responses</a></h2>

<p>If you point your <code>ErrorDocument</code> to some variety of
      dynamic handler such as a server-side include document, CGI
      script, or some variety of other handler, you may wish to use the
      available custom environment variables to customize this
      response.</p>

<p>If the ErrorDocument specifies a local redirect to a CGI
      script, the script should include a "<code>Status:</code>"
      header field in its output in order to ensure the propagation
      all the way back to the client of the error condition that
      caused it to be invoked. For instance, a Perl ErrorDocument
      script might include the following:</p>

<pre class="prettyprint lang-perl">...
print  "Content-type: text/html\n";
printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"};
...</pre>

<p>If the script is dedicated to handling a particular error
      condition, such as <code>404&nbsp;Not&nbsp;Found</code>, it can
      use the specific code and error text instead.</p>

<p>Note that if the response contains <code>Location:</code>
      header (in order to issue a client-side redirect), the script
      <em>must</em> emit an appropriate <code>Status:</code> header
      (such as <code>302&nbsp;Found</code>). Otherwise the
      <code>Location:</code> header may have no effect.</p>

</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="multi-lang" id="multi-lang">Multi Language Custom Error Documents</a></h2>

<p>Provided with your installation of the Apache HTTP Server is a
    directory of custom error documents translated into 16 different
    languages. There's also a configuration file in the
    <code>conf/extra</code> configuration directory that can be included
    to enable this feature.</p>

<p>In your server configuration file, you'll see a line such as:</p>

<pre class="prettyprint lang-config"># Multi-language error messages
#Include conf/extra/httpd-multilang-errordoc.conf</pre>

<p>Uncommenting this <code>Include</code> line will enable this
    feature, and provide language-negotiated error messages, based on
    the language preference set in the client browser.</p>

<p>Additionally, these documents contain various of the
    <code>REDIRECT_</code> variables, so that additional information can
    be provided to the end-user about what happened, and what they can
    do now.</p>

<p>These documents can be customized to whatever degree you wish to
    provide more useful information to users about your site, and what
    they can expect to find there.</p>

<p><code class="module"><a href="./mod/mod_include.html">mod_include</a></code> and <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>
    must be enabled to use this feature.</p>

</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/custom-error.html" title="English">&nbsp;en&nbsp;</a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed 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 Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><![CDATA[//><!]]></script></div><div id="footer">
<p class="apache">Copyright 2023 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><![CDATA[//><!]]></script>
</body></html>

${this.title}

Code Editor : custom-error.html.en