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
207
208
209
210
211
212
213
214
|
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- English Revision : 1361160 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<manualpage metafile="custom-error.xml.meta">
<title>Messages d'erreur personnalisés</title>
<summary>
<p>Le serveur HTTP Apache fournit des messages d'erreur génériques
pour les codes de statut 4xx ou 5xx ; ces messages sont cependant
relativement austères, imprécis, et peuvent s'avérer intimidants
pour les visiteurs du site. Si vous le souhaitez, vous pouvez
afficher des messages d'erreur plus conviviaux, dans un langage
autre que l'anglais, ou même sous une forme plus en adéquation avec
le style de votre site.</p>
<p>Il est possible de définir des messages d'erreur personnalisés
pour chaque code de statut HTTP associé à une condition d'erreur -
c'est à dire tout code de statut 4xx ou 5xx.</p>
<p>De plus, il est possible de
personnaliser le message d'erreur en fonction d'un jeu de valeurs
fourni, en utilisant les <a href="howto/ssi.html">Inclusions Côté
Serveur (SSI)</a>. Un programme CGI ou un autre gestionnaire
dynamique (PHP, mod_perl, etc...) peut aussi utiliser ces variables
pour gérer les conditions d'erreur.</p>
</summary>
<section id="configuration"><title>Configuration</title>
<p>Les messages d'erreur personnalisés sont configurés via la
directive <directive module="core">ErrorDocument</directive>, qui
peut être utilisée dans un contexte global, serveur virtuel ou
répertoire. On peut utiliser cette directive dans les fichiers
.htaccess si <directive module="core">AllowOverride</directive> est
définie à FileInfo.</p>
<highlight language="config">
ErrorDocument 500 "Désolé, notre script s'est
crashé ; comme c'est dommage !"<br />
ErrorDocument 500 /cgi-bin/crash-recover<br />
ErrorDocument 500 http://error.example.com/server_error.html<br />
ErrorDocument 404 /errors/not_found.html <br />
ErrorDocument 401 /subscription/how_to_subscribe.html
</highlight>
<p>La syntaxe de la directive <code>ErrorDocument</code> est :</p>
<highlight language="config">
ErrorDocument <code_3_chiffres> <action>
</highlight>
<p>où action peut être traitée comme :</p>
<ol>
<li>Une URL de redirection local (si l'action commence par un "/").</li>
<li>Une URL de redirection externe (si action est une URL valide).</li>
<li>Le texte à afficher (si l'action ne répond à aucune des
deux conditions précédentes). Entourez le texte de guillemets (")
s'il contient plusieurs mots.</li>
</ol>
<p>Dans le cas d'une redirection vers une URL locale, des variables
d'environnement supplémentaires sont définies de façon à ce que la
réponse puisse être personnalisée par la suite. Elles ne sont pas
envoyées aux URLs externes.</p>
</section>
<section id="variables"><title>Variables disponibles</title>
<p>La redirection vers une autre URL peut être utile, mais
seulement s'il est possible de transmettre certaines informations
qui pourront être utilisées pour expliquer ou journaliser
la condition d'erreur ou le problème plus clairement.</p>
<p>Pour y parvenir, lorsque la redirection d'erreur est envoyée,
des variables d'environnement supplémentaires sont définies à
partir des en-têtes de la requête originale en préfixant le nom
d'origine de l'en-tête par 'REDIRECT_', ce qui permet de fournir au
message d'erreur le contexte de la requête originelle.</p>
<p>Par exemple, en plus des variables d'environnement habituelles,
vous pouvez recevoir ce qui suit :</p>
<example>
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
</example>
<p>Les variables d'environnement <code>REDIRECT_</code> sont
créées à partir des variables d'environnement préexistantes à la
redirection qui sont préfixées par la chaîne <code>REDIRECT_</code> ;
par exemple, <code>HTTP_USER_AGENT</code> devient
<code>REDIRECT_HTTP_USER_AGENT</code>.</p>
<p><code>REDIRECT_URL</code>, <code>REDIRECT_STATUS</code>, et
<code>REDIRECT_QUERY_STRING</code> sont systématiquement définies,
les autres variables n'étant définies que si l'en-tête
correspondant existait avant la condition d'erreur.</p>
<p><strong>Aucune</strong> d'entre elles ne sera définie si votre
directive <directive module="core">ErrorDocument</directive>
spécifie une redirection <em>externe</em> (toute URL commençant
par un protocole du style <code>http:</code>, même si elle fait
référence au même hôte que le serveur).</p>
</section>
<section id="custom"><title>Personnalisation des messages d'erreur</title>
<p>Si vous faites pointer votre directive
<code>ErrorDocument</code> vers certains gestionnaires
dynamiques comme les inclusions côté serveur, les scripts CGI ou
d'autres gestionnaires, vous pouvez utiliser les variables
d'environnement supplémentaires disponibles pour personnaliser
le message.</p>
<p>Si la directive ErrorDname-basedocument spécifie une redirection locale
vers un script CGI, ce dernier doit ajouter un en-tête
"<code>Status:</code>" dans sa sortie afin de s'assurer du bon
acheminement jusqu'au client de la condition d'erreur qui a
provoqué cette redirection. Par exemple, un script Perl spécifié
par une directive ErrorDocument pourrait contenir ce qui suit
:</p>
<highlight language="perl">
...
print "Content-type: text/html\n"; <br />
printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
...
</highlight>
<p>Si un script est dédié à la gestion d'une condition d'erreur
spécifique, telle que <code>404 Not Found</code>, il
peut utiliser le code et le texte de l'erreur spécifiques à la
place.</p>
<p>Notez que si la réponse contient un en-tête
<code>Location:</code> (afin d'initier une redirection côté
client), le script <em>doit</em> émettre un en-tête approprié
(comme <code>302 Found</code>). Dans le cas contraire,
l'en-tête <code>Location:</code> ne produira aucun effet.</p>
</section>
<section id="multi-lang"><title>Messages d'erreur personnalisés
multilingues</title>
<p>Vous trouverez dans la distribution du serveur HTTP Apache un
répertoire contenant des messages d'erreur personnalisés traduits en
16 langues différentes. Pour activer cette fonctionnalité, vous
pouvez aussi inclure un fichier de configuration qui se trouve dans
le répertoire de configuration <code>conf/extra</code>.</p>
<p>Dans le fichier de configuration de votre serveur, vous trouverez
un groupe de lignes du style :</p>
<highlight language="config">
# Multi-language error messages<br />
#Include conf/extra/httpd-multilang-errordoc.conf
</highlight>
<p>Décommentez la ligne <code>Include</code> pour activer cette
fonctionnalité, et présenter des messages d'erreur dont le langage
sera négocié en fonction du langage préféré défini au niveau du
navigateur du client.</p>
<p>De plus, ces documents contiennent diverses variables
<code>REDIRECT_</code>, de façon à ce que l'utilisateur final
dispose d'informations supplémentaires à propos de ce qui a pu se
produire, et de ce qu'il est susceptible de faire maintenant.</p>
<p>Ces documents peuvent être personnalisés en fournissant autant
d'informations utiles que vous le souhaitez aux utilisateurs à
propos de votre site, et de ce qu'ils sont susceptibles d'y trouver.</p>
<p>Pour pouvoir utiliser cette fonctionnalité, vous devez activer
<module>mod_include</module> et <module>mod_negotiation</module>.</p>
</section>
</manualpage>
|
