<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1226481:1334008 (outdated) -->
+<!-- English Revision : 1334008 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<dt>Un nom de domaine (partiel)</dt>
<dd>
- <example><title>Exemple :</title>
- Allow from example.org<br />
- Allow from .net example.edu
- </example>
+ <highlight language="config">
+Allow from example.org
+Allow from .net example.edu
+ </highlight>
<p>Les hôtes dont les noms correspondent ou se terminent par la
chaîne spécifiée ont l'autorisation d'accès. Seules les
composantes entières du nom d'hôte doivent correspondre ; ainsi,
<dt>Une adresse IP complète</dt>
<dd>
- <example><title>Exemple :</title>
- Allow from 10.1.2.3<br />
- Allow from 192.168.1.104 192.168.1.205
- </example>
+ <highlight language="config">
+Allow from 10.1.2.3
+Allow from 192.168.1.104 192.168.1.205
+ </highlight>
<p>L'adresse IP d'un hôte auquel on a accordé l'accès</p></dd>
<dt>Une adresse IP partielle</dt>
<dd>
- <example><title>Exemple :</title>
- Allow from 10.1<br />
- Allow from 10 172.20 192.168.2
- </example>
+ <highlight language="config">
+Allow from 10.1
+Allow from 10 172.20 192.168.2
+ </highlight>
<p>De un à trois des premiers octets d'une adresse IP, afin de
restreindre l'accès à un sous-réseau.</p></dd>
<dt>Une paire réseau/masque de sous-réseau</dt>
<dd>
- <example><title>Exemple :</title>
+ <highlight language="config">
Allow from 10.1.0.0/255.255.0.0
- </example>
+ </highlight>
<p>Un réseau a.b.c.d, et un masque de sous-réseau w.x.y.z, pour
une définition plus précise de la restriction d'accès imposée à un
sous-réseau.</p></dd>
<dt>Une spécification CIDR réseau/nnn</dt>
<dd>
- <example><title>Exemple :</title>
+ <highlight language="config">
Allow from 10.1.0.0/16
- </example>
+ </highlight>
<p>Identique au cas précédent, mis à part que le masque est
constitué des nnn bits de poids fort.</p></dd>
</dl>
<p>On peut spécifier des adresses et sous-réseaux IPv6 de la manière
suivante :</p>
- <example>
- Allow from 2001:db8::a00:20ff:fea7:ccea<br />
- Allow from 2001:db8::a00:20ff:fea7:ccea/10
- </example>
+ <highlight language="config">
+Allow from 2001:db8::a00:20ff:fea7:ccea
+Allow from 2001:db8::a00:20ff:fea7:ccea/10
+ </highlight>
<p>Le troisième format d'argument de la directive
<directive>Allow</directive> permet de contrôler l'accès au serveur
(type de navigateur) des clients, le <code>Referer</code>, ou
d'autres champs d'en-tête de la requête HTTP.</p>
- <example><title>Exemple :</title>
- SetEnvIf User-Agent ^KnockKnock/2\.0 laissez_moi_entrer<br />
- <Directory /docroot><br />
- <indent>
- Order Deny,Allow<br />
- Deny from all<br />
- Allow from env=laissez_moi_entrer<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+SetEnvIf User-Agent ^KnockKnock/2\.0 let_me_in
+<Directory /docroot>
+ Order Deny,Allow
+ Deny from all
+ Allow from env=let_me_in
+</Directory>
+ </highlight>
<p>Dans cet exemple, les navigateurs dont la chaîne user-agent
commence par <code>KnockKnock/2.0</code> se verront accorder
l'autorisation d'accès ; tous les autres voient leur accès
refusé.</p>
- <example>
- Order Deny,Allow<br />
- Deny from all<br />
- Allow from example.org
- </example>
+ <highlight language="config">
+Order Deny,Allow
+Deny from all
+Allow from example.org
+ </highlight>
<p>Dans l'exemple suivant, tous les hôtes du domaine example.org ont
l'autorisation d'accès, sauf ceux du sous-domaine foo.example.org qui
module="mod_access_compat">Deny</directive>, et consiste donc en un
refus d'accès.</p>
- <example>
- Order Allow,Deny<br />
- Allow from example.org<br />
- Deny from foo.example.org
- </example>
+ <highlight language="config">
+Order Allow,Deny
+Allow from example.org
+Deny from foo.example.org
+ </highlight>
<p>Par contre, si la valeur de la directive
<directive>Order</directive>, dans l'exemple précédent, est
module="mod_access_compat">Deny</directive> associées, à cause de
son influence sur le statut par défaut. Par exemple,</p>
- <example>
- <Directory /www><br />
- <indent>
- Order Allow,Deny<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory /www>
+ Order Allow,Deny
+</Directory>
+ </highlight>
<p>va interdire tout accès au répertoire <code>/www</code> à cause
du statut d'accès par défaut qui est défini à <directive
que l'accès à cette zone nécessite un mot de passe pour les autres
utilisateurs, vous pouvez utiliser une configuration du style :</p>
- <example>
- Require valid-user<br />
- Allow from 192.168.1<br />
- Satisfy Any
- </example>
+ <highlight language="config">
+Require valid-user
+Allow from 192.168.1
+Satisfy Any
+ </highlight>
<p>
Une autre utilisation fréquente de la directive
répertoire parent :
</p>
- <example>
- <Directory /var/www/private><br />
- Require valid-user<br />
- </Directory><br />
- <br />
- <Directory /var/www/private/public><br />
- Allow from all<br />
- Satisfy Any<br />
- </Directory>
- </example>
+ <highlight language="config">
+<Directory /var/www/private>
+ Require valid-user
+</Directory>
+
+<Directory /var/www/private/public>
+ Allow from all
+ Satisfy Any
+</Directory>
+ </highlight>
<p>Dans l'exemple ci-dessus, l'accès au répertoire
<code>/var/www/private</code> nécessitera une authentification,
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1303776:1334008 (outdated) -->
+<!-- English Revision : 1334008 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
peut pas afficher d'images, si le chargement d'images est désactivé
ou si l'icône ne peut pas être trouvé.</p>
- <example><title>Exemples</title>
- AddAlt "Fichier PDF" *.pdf<br />
- AddAlt Compressé *.gz *.zip *.Z
- </example>
+ <highlight language="config">
+AddAlt "PDF file" *.pdf
+AddAlt Compressed *.gz *.zip *.Z
+ </highlight>
</usage>
</directivesynopsis>
peut pas afficher d'images, si le chargement d'images est désactivé
ou si l'icône ne peut pas être trouvé.</p>
- <example><title>Exemple</title>
+ <highlight language="config">
AddAltByEncoding gzip x-gzip
- </example>
+ </highlight>
</usage>
</directivesynopsis>
peut pas afficher d'images, si le chargement d'images est désactivé
ou si l'icône ne peut pas être trouvé.</p>
- <example><title>Exemple</title>
+ <highlight language="config">
AddAltByType 'Fichier texte' text/plain
- </example>
+ </highlight>
</usage>
</directivesynopsis>
<var>texte</var> doit être entouré de guillemets
(<code>"</code>).</p>
- <example><title>Exemple</title>
- AddDescription "La planète Mars" mars.gif
- </example>
+ <highlight language="config">
+AddDescription "The planet Mars" mars.gif
+AddDescription "My friend Marshall" friends/mars.gif
+ </highlight>
<p>La taille par défaut, habituelle du champ de description est de
23 octets. L'option <code><a href="#indexoptions.suppressicon"
et n'est donc pas nécessaire si vous utilisez <code>IndexOptions
HTMLTable</code>.</p>
- <example><title>Exemples</title>
- AddIcon (IMG,/icons/image.png) .gif .jpg .png<br />
- AddIcon /icons/dir.png ^^DIRECTORY^^<br />
- AddIcon /icons/backup.png *~
- </example>
+ <highlight language="config">
+#Examples
+AddIcon (IMG,/icons/image.png) .gif .jpg .png
+AddIcon /icons/dir.png ^^DIRECTORY^^
+AddIcon /icons/backup.png *~
+ </highlight>
<p>Lorsque c'est possible, il est préférable d'utiliser <directive
module="mod_autoindex">AddIconByType</directive> plutôt que
<p><var>codage MIME</var> doit être un codage valide, comme
<code>x-compress</code>.</p>
- <example><title>Exemple</title>
+ <highlight language="config">
AddIconByEncoding /icons/compress.png x-compress
- </example>
+ </highlight>
</usage>
</directivesynopsis>
<p><var>type MIME</var> est une expression avec caractères
génériques représentant le type MIME.</p>
- <example><title>Exemple</title>
+ <highlight language="config">
AddIconByType (IMG,/icons/image.png) image/*
- </example>
+ </highlight>
</usage>
</directivesynopsis>
<var>chemin URL</var> est une URL relative (échappée par des
caractères '%') vers l'icône ou une URL pleinement qualifiée.</p>
- <example><title>Exemple</title>
+ <highlight language="config">
DefaultIcon /icon/unknown.png
- </example>
+ </highlight>
</usage>
</directivesynopsis>
le nom du fichier qui sera inséré au début de la page contenant
l'index. <var>nom fichier</var> est le nom du fichier à inclure.</p>
- <example><title>Exemple</title>
+ <highlight language="config">
HeaderName HEADER.html
- </example>
+ </highlight>
<note>
<p>Les deux directives HeaderName et <directive
considéré comme relatif au répertoire défini par la directive
<directive module="core">DocumentRoot</directive>.</p>
- <example><title>Exemple</title>
+ <highlight language="config">
HeaderName /include/HEADER.html
- </example>
+ </highlight>
<p><var>nom fichier</var> doit correspondre à un document dont le
type MIME est du style <code>text/*</code> (<em>par exemple</em>
sortie) est marqué comme <code>text/html</code> par exemple à
l'aide d'une directive comme :</p>
- <example>
+ <highlight language="config">
AddType text/html .cgi
- </example>
+ </highlight>
<p>Une <a href="../content-negotiation.html">négociation de
contenu</a> sera effectuée si <directive
ignorer. Par défaut, la liste contient <code>.</code> (le répertoire
courant).</p>
- <example>
+ <highlight language="config">
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
- </example>
+ </highlight>
<note><title>Expressions rationnelles</title>
<p>Cette directive est actuellement incompatible avec les sections
<directive>IndexIgnore</directive> et héritée par ailleurs d'autres
sections de configuration.</p>
- <example>
- <Directory /var/www>
- IndexIgnore *.bak .??* *~ *# HEADER* README* RCS CVS *,v *,t
- </Directory>
- <Directory /var/www/backups>
- IndexIgnoreReset ON
- IndexIgnore .??* *# HEADER* README* RCS CVS *,v *,t
- </Directory>
- </example>
+ <highlight language="config">
+<Directory /var/www>
+ IndexIgnore *.bak .??* *~ *# HEADER* README* RCS CVS *,v *,t
+</Directory>
+<Directory /var/www/backups>
+ IndexIgnoreReset ON
+ IndexIgnore .??* *# HEADER* README* RCS CVS *,v *,t
+</Directory>
+ </highlight>
<note type="warning"><p>Revoyez la configuration par défaut pour une
liste de modèles que vous voulez ignorer explicitement après usage
système de fichiers sous-jacent utilise les noms de fichiers en
Unicode ou non).
- <example><title>Exemple :</title>
+ <highlight language="config">
IndexOptions Charset=UTF-8
- </example>
+ </highlight>
</dd>
<dt><a name="indexoptions.descriptionwidth"
MIME de la page générée. La valeur par défaut est
<var>text/html</var>.
- <example><title>Exemple :</title>
+ <highlight language="config">
IndexOptions Type=text/plain
- </example>
+ </highlight>
</dd>
apparaissant dans la même section directory sont maintenant
fusionnées. Le résultat de :
- <example>
- <Directory /foo>
- <indent>
- IndexOptions HTMLTable<br />
- IndexOptions SuppressColumnsorting
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory /foo>
+ IndexOptions HTMLTable
+ IndexOptions SuppressColumnsorting
+</Directory>
+ </highlight>
<p>est équivalent à</p>
- <example>
+ <highlight language="config">
IndexOptions HTMLTable SuppressColumnsorting
- </example>
+ </highlight>
</li>
<li>L'ajout de la syntaxe incrémentale (en préfixant les mots-clés
définition incrémentale. Considérons l'exemple
suivant :</p>
- <example>
- IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing<br />
- IndexOptions +SuppressSize
- </example>
+ <highlight language="config">
+IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing<br />
+IndexOptions +SuppressSize
+ </highlight>
<p>L'effet global est équivalent à l'effet qu'aurait provoqué
<code>IndexOptions FancyIndexing +SuppressSize</code>, car l'option
définir le nom du fichier qui servira de feuille de style CSS pour
l'index.
</p>
- <example>
- <title>Exemple</title>
+ <highlight language="config">
IndexStyleSheet "/css/style.css"
- </example>
+ </highlight>
<p>L'utilisation de cette directive en conjonction avec <code>IndexOptions
HTMLTable</code> ajoute plusieurs classes CSS au document HTML
spécifier une chaîne de caractères à insérer dans la section
<var><head></var> du code HTML généré pour la page
d'index.</p>
- <example>
- <title>Exemple</title>
+ <highlight language="config">
IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">"
- </example>
+ </highlight>
</usage>
</directivesynopsis>
module="core">DocumentRoot</directive>.
</p>
- <example><title>Exemple 1</title>
- ReadmeName FOOTER.html
- </example>
+ <highlight language="config">
+# Example 1
+ReadmeName FOOTER.html
+ </highlight>
- <example><title>Exemple 2</title>
- ReadmeName /include/FOOTER.html
- </example>
+ <highlight language="config">
+# Example 2
+ReadmeName /include/FOOTER.html
+ </highlight>
<p>Voir aussi la directive <directive module="mod_autoindex"
>HeaderName</directive>, où cette fonctionnalité est décrite plus en
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1326759:1334011 (outdated) -->
+<!-- English Revision : 1334011 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
listing du répertoire.</p>
<example><title>Exemple</title>
+ <highlight language="config">
DirectoryIndex index.html
+ </highlight>
</example>
<p>Avec cette configuration, une requête pour l'URL
<p>Notez qu'il n'est pas nécessaire que les documents soient
relatifs au répertoire ;</p>
- <example>
+ <highlight language="config">
DirectoryIndex index.html index.txt /cgi-bin/index.pl
- </example>
+ </highlight>
<p>provoquerait l'exécution du script CGI
<code>/cgi-bin/index.pl</code> si aucun des fichiers
client vers une ressource externe.</p>
<example><title>Exemple</title>
+ <highlight language="config">
DirectoryIndexRedirect on
+ </highlight>
</example>
<p>Une requête pour <code>http://example.com/docs/</code> se
Gardez cependant à l'esprit que ceci peut avoir des répercutions en
matière de sécurité.</p>
- <example>
- # voir l'avertissement de sécurité ci-dessous !<br />
- <Location /un/chemin><br />
- <indent>
- DirectorySlash Off<br />
- SetHandler un-gestionnaire<br />
- </indent>
- </Location>
- </example>
+ <highlight language="config">
+# voir l'avertissement de sécurité ci-dessous !
+<Location /some/path>
+ DirectorySlash Off
+ SetHandler some-handler
+</Location>
+ </highlight>
<note type="warning"><title>Avertissement de sécurité</title>
<p>La désactivation de la redirection "slash de fin" peut entraîner
et qui provoquerait sans cela l'envoi d'un code d'erreur HTTP 404
(Not Found).
Par exemple</p>
- <example>
- <code>FallbackResource /not-404.php</code>
- </example>
+ <highlight language="config">
+ FallbackResource /not-404.php
+ </highlight>
<p>fait en sorte que les requêtes ne correspondant à aucun fichier
soient traitées par <code>non-404.php</code>, sans affecter les
requêtes pour des fichiers existants.</p>
conditionnels <code>-f</code> et <code>-d</code> pour vérifier
l'existence des fichiers et répertoires. Maintenant, une seule ligne
de configuration est nécessaire.</p>
- <example>
- <code>FallbackResource /index.php</code>
- </example>
+ <highlight language="config">
+ FallbackResource /index.php
+ </highlight>
<p>Les fichiers existants comme des images, des fichiers css, etc...
seront traités normalement.</p>
<p>Pour un URI intermédiaire tel que
<em>http://example.com/blog/</em>, cet URI intermédiaire doit être
spécifié en tant que <var>url-locale</var> :</p>
- <example>
- <code>
- <Directory /web/example.com/htdocs/blog><br />
- <indent>
- FallbackResource /blog/index.php<br />
- </indent>
- </Directory>
- </code>
- </example>
+ <highlight language="config">
+<Directory /web/example.com/htdocs/blog>
+ FallbackResource /blog/index.php
+</Directory>
+ </highlight>
</usage>
</directivesynopsis>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1231453:1334016 (outdated) -->
+<!-- English Revision : 1334016 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
ces deux directives ont un effet différent si leur ordre est inversé
:</p>
- <example>
- RequestHeader append MirrorID "mirror 12"<br />
- RequestHeader unset MirrorID
- </example>
+ <highlight language="config">
+RequestHeader append MirrorID "mirror 12"
+RequestHeader unset MirrorID
+ </highlight>
<p>Dans cet ordre, l'en-tête <code>MirrorID</code> n'est pas défini.
Si l'ordre des directives était inversé, l'en-tête
Copie tous les en-têtes de requête qui commencent par "TS" vers
les en-têtes de la réponse :
- <example>
+ <highlight language="config">
Header echo ^TS
- </example>
+ </highlight>
</li>
<li>
isoler les goulets d'étranglement entre le client et le
serveur.
- <example>
+ <highlight language="config">
Header set mon-en-tête "%D %t"
- </example>
+ </highlight>
<p>le résultat est l'ajout à la réponse d'un en-tête du type :</p>
<p>le résultat est l'ajout à la réponse d'un en-tête du type :</p>
- <example>
- mon-en-tête: Bonjour Joe. Il a fallu D=3775428 microsecondes à Apache
- pour servir cette requête.
- </example>
+ <highlight language="config">
+ Header set MyHeader "Bonjour Joe. Il a fallu D=3775428 microsecondes à Apache
+ pour servir cette requête."
+ </highlight>
</li>
<li>
exemple nécessite les services du module
<module>mod_setenvif</module>.
- <example>
- SetEnvIf mon-en-tête-requête mavaleur HAVE_MyRequestHeader<br />
- Header set mon-en-tête "%D %t montexte" env=HAVE_MyRequestHeader
- </example>
+ <highlight language="config">
+SetEnvIf MyRequestHeader myvalue HAVE_MyRequestHeader
+Header set MyHeader "%D %t mytext" env=HAVE_MyRequestHeader
+ </highlight>
<p>Si l'en-tête <code>mon-en-tête-requête: mavaleur</code> est
présent dans la requête HTTP, la réponse contiendra un en-tête
du problème</a>) en remplaçant <var>https:</var> par
<var>http:</var> dans l'en-tête <var>Destination</var> :
- <example>
+ <highlight language="config">
RequestHeader edit Destination ^https: http: early
- </example>
+ </highlight>
</li>
<li>
<code>NO_CACHE</code> et <code>NO_STORE</code> existent pour la
requête) :
- <example>
- Header merge Cache-Control no-cache env=CGI<br />
- Header merge Cache-Control no-cache env=NO_CACHE<br />
- Header merge Cache-Control no-store env=NO_STORE
- </example>
+ <highlight language="config">
+Header merge Cache-Control no-cache env=CGI
+Header merge Cache-Control no-cache env=NO_CACHE
+Header merge Cache-Control no-store env=NO_STORE
+ </highlight>
<p>alors, la réponse contiendra l'en-tête suivant :</p>
<li>
Définit un cookie de test si et seulement si le client n'envoie
pas de cookie
- <example>
+ <highlight language="config">
Header set Set-Cookie testcookie "expr=-z %{req:Cookie}"
- </example>
+ </highlight>
</li>
</ol>
</section>