<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1326770:1334008 (outdated) -->
+<!-- English Revision : 1334008 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
au moins précis afin que toutes les directives puissent
éventuellement s'appliquer, comme dans l'exemple suivant :</p>
- <example>
- Alias /foo/bar /baz<br />
- Alias /foo /gaq
- </example>
+ <highlight language="config">
+Alias /foo/bar /baz
+Alias /foo /gaq
+ </highlight>
<p>Si l'ordre des directives était inversé, la directive <directive
module="mod_alias">Alias</directive> ayant pour argument
est sensible à la casse, même sur les systèmes de fichiers
insensibles à la casse.</p>
- <example><title>Exemple :</title>
+ <highlight language="config">
Alias /image /ftp/pub/image
- </example>
+ </highlight>
<p>Une requête pour <code>http://example.com/image/foo.gif</code> fera
renvoyer par le serveur le fichier
<directive module="core">DocumentRoot</directive>, vous devrez
probablement permettre explicitement l'accès à ce répertoire.</p>
- <example><title>Exemple :</title>
- Alias /image /ftp/pub/image<br />
- <Directory /ftp/pub/image><br />
- <indent>
- Require all granted<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+Alias /image /ftp/pub/image
+<Directory /ftp/pub/image>
+ Require all granted
+</Directory>
+ </highlight>
</usage>
</directivesynopsis>
Par exemple, pour activer le répertoire <code>/icons</code>, on peut
utiliser :</p>
- <example>
+ <highlight language="config">
AliasMatch ^/icons(.*) /usr/local/apache/icons$1
- </example>
+ </highlight>
<p>Toute la puissance des <glossary ref="regex">expressions
rationnelles</glossary> peut être mise à contribution. Par exemple,
il est possible de construire un alias avec un modèle de chemin URL
insensible à la casse :</p>
- <example>
+ <highlight language="config">
AliasMatch (?i)^/image(.*) /ftp/pub/image$1
- </example>
+ </highlight>
<p>Il existe une différence subtile entre <directive
module="mod_alias">Alias</directive> et <directive
<p>Par exemple, supposons que nous voulions reformuler cet alias
avec AliasMatch :</p>
- <example>
+ <highlight language="config">
Alias /image/ /ftp/pub/image/
- </example>
+ </highlight>
<p>Le simple remplacement d'Alias par AliasMatch ne produira pas le
même résultat. Ainsi, ce qui suit va rediriger toutes les requêtes
qui contiennent /image/ vers /ftp/pub/image/ :</p>
- <example>
+ <highlight language="config">
AliasMatch /image/ /ftp/pub/image/
- </example>
+ </highlight>
<p>Voici la directive AliasMatch qui produira le même résultat que
la directive Alias ci-dessus :</p>
- <example>
+ <highlight language="config">
AliasMatch ^/image/(.*)$ /ftp/pub/image/$1
- </example>
+ </highlight>
<p>Bien entendu, il n'y a aucune raison d'utiliser <directive
module="mod_alias">AliasMatch</directive> dans le cas où <directive
servir différentes sortes de fichiers à partir de répertoires
différents :</p>
- <example>
+ <highlight language="config">
AliasMatch ^/image/(.*)\.jpg$ /fichiers/jpg.images/$1.jpg<br/>
AliasMatch ^/image/(.*)\.gif$ /fichiers/gif.images/$1.gif
- </example>
+ </highlight>
</usage>
</directivesynopsis>
élément de chemin supplémentaire situé en aval du <em>chemin
URL</em> sera ajouté à l'URL cible.</p>
- <example><title>Exemple :</title>
- # Redirige vers une URL sur un serveur différent<br />
- Redirect /service http://foo2.example.com/service<br />
- <br />
- # Redirige vers une URL sur le même serveur<br />
- Redirect /one /two
- </example>
+ <highlight language="config">
+# Redirige vers une URL sur un serveur différent
+Redirect /service http://foo2.example.com/service
+
+# Redirige vers une URL sur le même serveur
+Redirect /one /two
+ </highlight>
<p>Si le client effectue une requête pour l'URL
<code>http://example.com/service/foo.txt</code>, il lui sera demandé
fonction <code>send_error_response</code> dans
http_protocol.c).</p>
- <example><title>Exemple :</title>
- Redirect permanent /un http://example.com/deux<br />
- Redirect 303 /trois http://example.com/autre
- </example>
+ <highlight language="config">
+Redirect permanent /one http://example.com/two
+Redirect 303 /three http://example.com/other
+ </highlight>
</usage>
</directivesynopsis>
les fichiers GIF vers les fichiers JPEG de même nom sur un autre
serveur, on peut utiliser :</p>
- <example>
+ <highlight language="config">
RedirectMatch (.*)\.gif$ http://autre.example.com$1.jpg
- </example>
+ </highlight>
<p>Les remarques à propos de la différence entre <directive
module="mod_alias">Alias</directive> et <directive
second argument, qui est un chemin complet dans le système de
fichiers local.</p>
- <example><title>Exemple :</title>
+ <highlight language="config">
ScriptAlias /cgi-bin/ /web/cgi-bin/
- </example>
+ </highlight>
<p>Une requête pour <code>http://example.com/cgi-bin/foo</code>
ferait exécuter par le serveur le script
<code>/web/cgi-bin/foo</code>. Cette configuration est sensiblement
équivalente à :</p>
- <example>
- Alias /cgi-bin/ /web/cgi-bin/<br />
- <Location /cgi-bin ><br />
- <indent>
- SetHandler cgi-script<br />
- Options +ExecCGI<br />
- </indent>
- </Location>
- </example>
+ <highlight language="config">
+Alias /cgi-bin/ /web/cgi-bin/
+<Location /cgi-bin >
+ SetHandler cgi-script
+ Options +ExecCGI
+</Location>
+ </highlight>
<p>Vous pouvez aussi utiliser <directive>ScriptAlias</directive>
avec un script ou gestionnaire de votre cru. Par exemple :</p>
- <example>
+ <highlight language="config">
ScriptAlias /cgi-bin/ /web/cgi-handler.pl
- </example>
+ </highlight>
<p>Dans ce scénario, tous les fichiers faisant l'objet d'une requête
dans <code>/cgi-bin/</code> seront traités par le fichier que vous
module="core" type="section">Directory</directive>, <directive
module="core">SetHandler</directive>, et <directive
module="core">Options</directive> comme dans l'exemple suivant :
- <example>
- <Directory /usr/local/apache2/htdocs/cgi-bin ><br />
- <indent>
- SetHandler cgi-script<br />
- Options ExecCGI<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory /usr/local/apache2/htdocs/cgi-bin >
+ SetHandler cgi-script
+ Options ExecCGI
+</Directory>
+ </highlight>
Ceci est nécessaire car plusieurs <var>chemins URL</var> peuvent
correspondre à la même zone du système de fichiers, court-circuitant
ainsi la directive <directive>ScriptAlias</directive> et révélant le
comme nom de fichier. Par exemple, pour activer le répertoire
standard <code>/cgi-bin</code>, on peut utiliser :</p>
- <example>
+ <highlight language="config">
ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1
- </example>
+ </highlight>
<p>Comme dans le cas d'AliasMatch, toute la puissance des <glossary
ref="rexex">expressions rationnelles</glossary> peut être mise à
contribution. Par exemple, il est possible de construire un alias
avec une comparaison du modèle du chemin URL insensible à la casse :</p>
- <example>
+ <highlight language="config">
ScriptAliasMatch (?i)^/cgi-bin(.*) /usr/local/apache/cgi-bin$1
- </example>
+ </highlight>
<p>Les remarques à propos de la différence entre <directive
module="mod_alias">Alias</directive> et <directive
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1303783:1334008 (outdated) -->
+<!-- English Revision : 1334008 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
un module d'authentification comme <module>mod_auth_basic</module>
ou <module>mod_auth_digest</module>.
<module>mod_authz_owner</module> reconnaît deux arguments pour la
- directive <directive module="mod_authz_core">Require</directive> :
+ directive <directive module="core">Require</directive> :
<code>file-owner</code> et <code>file-group</code> :</p>
<dl>
propriétaire ne soit <code>jones</code> au lieu de
<code>smith</code>.</p>
- <example>
- <Directory /home/*/public_html/private><br />
- <indent>
- AuthType Basic<br />
- AuthName mes-fichiers-prive<br />
- AuthBasicProvider dbm<br />
- AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all<br />
- Require file-owner<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory /home/*/public_html/private>
+ AuthType Basic
+ AuthName MyPrivateFiles
+ AuthBasicProvider dbm
+ AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all
+ Require file-owner
+</Directory>
+ </highlight>
</section>
<section id="examples.file-group"><title>Require file-group</title>
<code>foo</code>, ils seront autorisés à accéder aux
répertoires <code>project-foo</code> de chacun d'entre eux.</p>
- <example>
- <Directory /home/*/public_html/project-foo><br />
- <indent>
- AuthType Basic<br />
- AuthName "Project Foo Files"<br />
- AuthBasicProvider dbm<br />
- <br />
- # combined user/group database<br />
- AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all<br />
- AuthDBMGroupFile /usr/local/apache2/etc/.htdbm-all<br />
- <br />
- Satisfy All<br />
- Require file-group<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory /home/*/public_html/project-foo>
+ AuthType Basic
+ AuthName "Project Foo Files"
+ AuthBasicProvider dbm
+
+ # combined user/group database
+ AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all
+ AuthDBMGroupFile /usr/local/apache2/etc/.htdbm-all
+
+ Satisfy All
+ Require file-group
+</Directory>
+ </highlight>
</section>
</section>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1307367:1334016 (outdated) -->
+<!-- English Revision : 1334016 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
module="mod_expires">ExpiresDefault</directive> et <directive
module="mod_expires">ExpiresByType</directive> comme suit :</p>
- <example>
- ExpiresDefault "<var>base</var> [plus <var>num</var> <var>type</var>]
- [<var>num</var> <var>type</var>] ..."<br />
- ExpiresByType type/encoding "<var>base</var> [plus <var>num</var> <var>type</var>]
- [<var>num</var> <var>type</var>] ..."
- </example>
+ <highlight language="config">
+ExpiresDefault "<var>base</var> [plus <var>num</var> <var>type</var>] [<var>num</var> <var>type</var>] ..."
+ExpiresByType type/encoding "<var>base</var> [plus <var>num</var> <var>type</var>] [<var>num</var> <var>type</var>] ..."
+ </highlight>
<p>où <var>base</var> peut être :</p>
<p>Par exemple, pour faire expirer par défaut les documents 1 mois
après leur accès, on peut utiliser une des directives suivantes :</p>
- <example>
- ExpiresDefault "access plus 1 month"<br />
- ExpiresDefault "access plus 4 weeks"<br />
- ExpiresDefault "access plus 30 days"
- </example>
+ <highlight language="config">
+ExpiresDefault "access plus 1 month"
+ExpiresDefault "access plus 4 weeks"
+ExpiresDefault "access plus 30 days"
+ </highlight>
<p>La date d'expiration peut être définie plus précisément en
ajoutant plusieurs clauses '<var>num</var> <var>type</var>' :</p>
- <example>
- ExpiresByType text/html "access plus 1 month 15
- days 2 hours"<br />
- ExpiresByType image/gif "modification plus 5 hours 3
- minutes"
- </example>
+ <highlight language="config">
+ExpiresByType text/html "access plus 1 month 15 days 2 hours"
+ExpiresByType image/gif "modification plus 5 hours 3 minutes"
+ </highlight>
<p>Notez que si vous utilisez une configuration basée sur la date de
modification, l'en-tête Expires ne sera pas ajouté à un contenu qui
de temps assez court).</p>
<example><title>Exemple :</title>
- # active la génération des en-têtes Expires<br />
- ExpiresActive On<br />
- # les images GIF expirent au bout d'un mois dans le cache du
- # client<br />
- ExpiresByType image/gif A2592000<br />
- # les documents HTML restent valables une semaine après leur date
- # de dernière modification<br />
- ExpiresByType text/html M604800
+ <highlight language="config">
+# active la génération des en-têtes Expires
+ExpiresActive On
+# les images GIF expirent au bout d'un mois dans le cache du
+# client
+ExpiresByType image/gif A2592000
+# les documents HTML restent valables une semaine après leur date
+# de dernière modification
+ExpiresByType text/html M604800
+ </highlight>
</example>
<p>Notez que cette directive ne produit d'effet que si