Updates. (afeb853c) · Commits · CYBER - Cyber Security / TS 103 523 MSP / TLMSP / TLMSP Apache Httpd

docs/manual/caching.xml.fr

+12 −14

Changes for docs/manual/caching.xml.fr: 12 added lines, 14 removed lines.
Original line number	Diff line number	Diff line
		@@ -3,7 +3,7 @@
		<?xml-stylesheet type="text/xsl" href="style/manual.fr.xsl"?>
		<!-- French translation : Lucien GENTIS -->
		<!-- Reviewed by : Vincent Deffontaines -->
		<!-- English Revision : 1037244 -->
		<!-- English Revision : 1058639 -->

		<!--
		Licensed to the Apache Software Foundation (ASF) under one or more
		@@ -163,12 +163,11 @@
		<a href="howto/ssi.html">Inclusions Côté Serveur (SSI)</a>;</p>

		<example>
		<pre>
		<!-- L'inclusion suivante peut être mise en cache -->
		<!--#include virtual="/footer.html" -->

		<!-- L'inclusion suivante ne peut pas être mise en cache -->
		<!--#include file="/path/to/footer.html" --></pre>
		<!-- L'inclusion suivante peut être mise en cache --><br />
		<!--#include virtual="/footer.html" --><br />
		<br />
		<!-- L'inclusion suivante ne peut pas être mise en cache --><br />
		<!--#include file="/path/to/footer.html" --> <br />
		</example>

		<p>Si vous utilisez les SSI, et voulez bénéficier de la vitesse de
		@@ -487,7 +486,7 @@ Vary: negotiate,accept-language,accept-charset
		accès ultérieurs à ce fichier.</p>

		<example>
		<pre>CacheFile /usr/local/apache2/htdocs/index.html</pre>
		CacheFile /usr/local/apache2/htdocs/index.html
		</example>

		<p>Si vous avez l'intention de mettre en cache un grand nombre de
		@@ -608,7 +607,7 @@ sys 0m0.000s</pre>
		toutes les demandes d'accès à ce fichier.</p>

		<example>
		<pre>MMapFile /usr/local/apache2/htdocs/index.html</pre>
		MMapFile /usr/local/apache2/htdocs/index.html
		</example>

		<p>Comme dans le cas de la directive
		@@ -649,11 +648,10 @@ sys 0m0.000s</pre>
		<p>Typiquement, le module sera configuré comme suit :</p>

		<example>
		<pre>
		CacheRoot /var/cache/apache/
		CacheEnable disk /
		CacheDirLevels 2
		CacheDirLength 1</pre>
		CacheRoot /var/cache/apache/<br />
		CacheEnable disk /<br />
		CacheDirLevels 2<br />
		CacheDirLength 1
		</example>

		<p>Il est important de savoir que, les fichiers mis en cache étant stockés

docs/manual/dso.xml.fr

+11 −16

Changes for docs/manual/dso.xml.fr: 11 added lines, 16 removed lines.
Original line number	Diff line number	Diff line
		@@ -3,7 +3,7 @@
		<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
		<!-- French translation : Lucien GENTIS -->
		<!-- Reviewed by : Vincent Deffontaines -->
		<!-- English Revision : 952009 -->
		<!-- English Revision : 1058587 -->

		<!--
		Licensed to the Apache Software Foundation (ASF) under one or more
		@@ -65,8 +65,8 @@
		distribués seront alors compilés en tant que modules DSO. Une fois
		compilé en tant que module DSO nommé <code>mod_foo.so</code>, un
		module peut être chargé en mémoire au
		démarrage ou redémarrage du serveur à l'aide de la commande
		<directive module="mod_so">LoadModule</directive> du module
		démarrage ou redémarrage du serveur à l'aide de
		la directive <directive module="mod_so">LoadModule</directive> du module
		<module>mod_so</module>, placée
		dans votre fichier <code>httpd.conf</code>.</p>
		<p>La compilation en mode DSO peut être désactivée pour certains
		@@ -149,8 +149,8 @@ $ apxs -cia mod_foo.c

		<section id="background"><title>Les dessous du fonctionnement des DSO</title>

		<p>Les clônes modernes d'UNIX proposent un astucieux mécanisme
		communément appelé édition de liens et chargement dynamiques d'
		<p>Les clônes modernes d'UNIX proposent un mécanisme
		appelé édition de liens et chargement dynamiques d'
		<em>Objets Dynamiques Partagés</em> (DSO), qui permet de construire un
		morceau de programme dans un format spécial pour le rendre chargeable
		à l'exécution dans l'espace d'adressage d'un programme exécutable.</p>
		@@ -240,8 +240,7 @@ $ apxs -cia mod_foo.c
		c'est dans cette optique que le mécanisme DSO a été conçu ; c'est cette
		approche qui est ainsi
		utilisée par pratiquement tous les types de bibliothèques que fournit le
		système d'exploitation. Par contre, les objets partagés sont relativement
		peu utilisés pour étendre les fonctionnalités d'un programme.</p>
		système d'exploitation.</p>

		</section>

		@@ -252,23 +251,23 @@ $ apxs -cia mod_foo.c

		<ul>
		<li>Le paquetage du serveur est plus flexible à l'exécution car le
		processus serveur effectif peut être assemblé à l'exécution via la
		processus serveur peut être assemblé à l'exécution via la
		directive <directive module="mod_so">LoadModule</directive> du fichier de
		configuration <code>httpd.conf</code> plutôt que par des options du script
		<program>configure</program> à la compilation. Par exemple,
		on peut ainsi exécuter différentes instances du serveur
		(standard et version SSL, version minimale et version étoffée
		[mod_perl, PHP3], <em>etc...</em>) à partir d'une seule installation
		(standard et version SSL, version minimale et version dynamique
		[mod_perl, mod_php], <em>etc...</em>) à partir d'une seule installation
		d'Apache httpd.</li>

		<li>Le paquetage du serveur peut être facilement étendu avec des modules
		tiers, même après l'installation. Ceci présente en tout cas un gros
		tiers, même après l'installation. Ceci présente un gros
		avantage pour les mainteneurs de paquetages destinés aux distributions,
		car ils peuvent créer un paquetage Apache httpd de base, et des paquetages
		additionnels contenant des extensions telles que PHP, mod_perl, mod_fastcgi,
		<em>etc...</em></li>

		<li>Une facilité de prototypage des modules Apache httpd car la paire
		<li>Une facilité de prototypage des modules Apache httpd, car la paire
		DSO/<program>apxs</program> vous permet d'une part de travailler en
		dehors de l'arborescence des sources d'Apache httpd, et d'autre part de n'avoir
		besoin que de la commande <code>apxs -i</code>
		@@ -280,10 +279,6 @@ $ apxs -cia mod_foo.c
		<p>Inconvénients des DSO :</p>

		<ul>
		<li>Le mécanisme DSO n'est pas disponible sur toutes les plates-formes
		car tous les systèmes d'exploitation ne supportent pas le chargement
		dynamique de code dans l'espace d'adressage d'un programme.</li>

		<li>Le serveur est environ 20 % plus lent au démarrage
		à cause des résolutions de symboles supplémentaires que le chargeur
		Unix doit effectuer.</li>

docs/manual/mod/mod_alias.xml.fr

+172 −170

File changed.

Preview size limit exceeded, changes collapsed.

docs/manual/mod/mod_rewrite.xml.fr

+114 −68

Changes for docs/manual/mod/mod_rewrite.xml.fr: 114 added lines, 68 removed lines.
Original line number	Diff line number	Diff line
		<?xml version="1.0"?>
		<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
		<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
		<!-- English Revision : 1044738 -->
		<!-- English Revision : 1063587 -->
		<!-- French translation : Lucien GENTIS -->
		<!-- Reviewed by : Vincent Deffontaines -->

		@@ -316,17 +316,22 @@ répertoire</description>
		<p>La directive <directive>RewriteBase</directive> définit
		explicitement le chemin URL de base (et non le chemin du
		répertoire dans le système de fichiers !) pour les réécritures dans un contexte
		de répertoire. Lorsque vous utilisez une directive <directive
		de répertoire dont le résultat est la substitution d'un
		chemin relatif. Lorsque vous utilisez une directive <directive
		module="mod_rewrite">RewriteRule</directive> dans un fichier
		<code>.htaccess</code>, <module>mod_rewrite</module> enlève le
		préfixe de répertoire local avant d'effectuer le traitement, puis
		réécrit ce qui reste de l'URL. Lorsque la réécriture est terminée,
		<module>mod_rewrite</module> rajoute automatiquement le préfixe de
		répertoire local au chemin.</p>
		<module>mod_rewrite</module> ajoute automatiquement le préfixe de
		répertoire local (ou la valeur de la directive
		<directive>RewriteBase</directive> si cette dernière est définie)
		à la chaîne de substitution avant de la remettre à disposition du
		serveur, comme s'il s'agissait de l'URL d'origine.</p>

		<p>Cette directive est <em>requise</em> pour les réécritures
		dans un contexte de répertoire défini via la directive
		<directive module="mod_alias">Alias</directive>.</p>
		<directive module="mod_alias">Alias</directive> lorsque la
		substitution utilise un chemin relatif.</p>

		<p>Si votre chemin URL n'existe pas réellement dans le système de
		fichiers, ou ne trouve pas directement sous le répertoire défini
		@@ -481,6 +486,7 @@ la réécriture soit effectuée
		REQUEST_FILENAME<br />
		IS_SUBREQ<br />
		HTTPS<br />
		REQUEST_SCHEME<br />
		</td>
		</tr>
		</table>
		@@ -489,7 +495,14 @@ la réécriture soit effectuée
		HTTP de mêmes noms, au variables C du serveur HTTP Apache, ou
		aux champs <code>struct tm</code> du système Unix. La
		plupart d'entre elles sont documentées ailleurs dans le
		manuel ou dans la spécification CGI. Parmi les variables
		manuel ou dans la spécification CGI.</p>

		<p>SERVER_NAME et SERVER_PORT dépendent respectivement
		des valeurs des directives <directive
		module="core">UseCanonicalName</directive> et <directive
		module="core">UseCanonicalPhysicalPort</directive>.</p>

		<p>Parmi les variables
		spécifiques à mod_rewrite, ou trouve les suivantes :</p>
		<note>
		<dl>
		@@ -543,11 +556,23 @@ la réécriture soit effectuée
		(Cette variable peut être utilisée sans problème, que
		<module>mod_ssl</module> soit chargé ou non.</dd>

		<dt><code>REQUEST_SCHEME</code></dt>

		<dd>Contient le protocole de la requête (en général
		"http" ou "https"). La valeur peut être modifiée par
		la directive <directive
		module="core">ServerName</directive>.</dd>

		</dl>
		</note>
		</li>
		</ul>

		<p>Si la <em>chaîne de test</em> contient la valeur spéciale
		<code>expr</code>, <em>expression de comparaison</em> sera traité
		en tant qu'expression rationnelle de type <a
		href="../expr.html">ap_expr</a>.</p>

		<p>Autres points à connaître ::</p>
		<ol>
		<li>
		@@ -824,6 +849,25 @@ la réécriture soit effectuée
		</note>
		</li>

		<li>
		<p>Si la <em>chaîne de test</em> contient la valeur spéciale
		<code>expr</code>, la <em>chaîne de comparaison</em> sera
		traitée en tant qu'expression rationnelle de type <a
		href="../expr.html">ap_expr</a>.</p>

		<p>
		Dans l'exemple ci-dessous, on utilise <code>-strmatch</code>
		pour comparer le <code>REFERER</code> avec le nom d'hôte du
		site afin de bloquer le hotlinking (référencement direct)
		non désiré.
		</p>

		<example>
		RewriteCond expr "! %{HTTP_REFERER} -strmatch '://%{HTTP_HOST}/'"<br />
		RewriteRule ^/images - [F]
		</example>
		</li>

		<li>Vous pouvez aussi définir certains drapeaux pour
		l'<em>expression de comparaison</em> en ajoutant ces
		<strong><code>[</code><em>drapeaux</em><code>]</code></strong>
		@@ -933,35 +977,79 @@ RewriteRule ^/$ /homepage.std.html [L]
		<p><a id="patterns" name="patterns"><em>Modèle</em></a> est une
		<a id="regexp" name="regexp">expression rationnelle</a>
		compatible perl. Dans la première règle de réécriture,
		l'expression est comparée au (%-encoded)
		l'expression est comparée au (%-decoded)
		<a href="./directive-dict.html#Syntax">chemin de l'URL</a> de la
		requête ; les expressions suivantes sont comparées à la sortie de
		la dernière règle de réécriture qui a été appliquée.</p>

		<note><title>Qu'est-ce qui est comparé ?</title>
		<p>Le <em>Modèle</em> est d'abord comparé à la partie
		de l'URL après le nom d'hôte et le port, et avant la chaîne de
		requête.</p>

		<p>Dans un contexte de répertoire, <em>Modèle</em> est comparé à
		ce qui reste de l'URL après suppression du préfixe qui a conduit
		Apache httpd à la règle courante (voir la directive <directive
		module="mod_rewrite">RewriteBase</directive>). Le préfixe supprimé
		se termine toujours par un slash, ce qui signifie que la
		correspondance se fera toujours avec une chaîne qui ne commence
		pas par un slash. Un <em>Modèle</em> contenant <code>^/</code> ne
		correspondra jamais dans un contexte de répertoire.</p>
		<p>Dans un contexte de serveur virtuel <directive
		module="core">VirtualHost</directive>, le <em>modèle</em> est tout
		d'abord comparé à la portion de l'URL située entre le nom d'hôte
		éventuellement accompagné du port, et la chaîne de paramètres (par
		exemple "/app1/index.html").</p>

		<p>Dans les contextes de répertoire <directive
		module="core">Directory</directive> et htaccess, le
		<em>modèle</em> est tout d'abord comparé au chemin du <em>système
		de fichiers</em>, après suppression du préfixe ou chemin de base
		ayant conduit à la règle <directive>RewriteRule</directive> (par
		exemple "app1/index.html" ou
		"index.html" selon l'endroit où les directives sont définies).</p>

		<p>Si vous souhaitez faire une comparaison sur le nom
		d'hôte, le port, ou la chaîne de requête, utilisez une
		directive <directive module="mod_rewrite">RewriteCond</directive>
		comportant respectivement les variables
		<code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, ou
		<code>%{QUERY_STRING}</code>. Si vous désirez effectuer une
		correspondance avec l'ensemble du chemin de l'URL dans un contexte
		de répertoire (htaccess), utilisez la variable
		<code>%{REQUEST_URI}</code>.</p>
		<code>%{QUERY_STRING}</code>.</p>
		</note>

		<note><title>Réécritures dans un contexte de répertoire</title>
		<ul>
		<li>L'utilisation du moteur de réécriture dans les
		fichiers <a href="../howto/htaccess.html">.htaccess</a> et les sections
		<directive
		type="section" module="core">Directory</directive> est un peu plus
		complexe.</li>

		<li>Pour activer le moteur de réécriture dans ces contextes, vous devez
		définir "<code>RewriteEngine On</code>" <strong>et</strong>
		"<code>Options FollowSymLinks</code>". Si l'administrateur a désactivé
		la possibilité de modifier l'option <code>FollowSymLinks</code> au
		niveau du répertoire d'un utilisateur, vous ne pouvez pas utiliser le
		moteur de réécriture. Cette restriction a été instaurée à des fins de
		sécurité.</li>

		<li>Lorsqu'on utilise le moteur de réécriture dans un fichier
		<code>.htaccess</code>, le chemin de base du répertoire courant (qui est
		toujours le même pour ce même répertoire) est automatiquement
		<em>supprimé</em> au cours de la comparaison avec le modèle de la règle
		de réécriture, et automatiquement <em>ajouté</em> lorsqu'une
		substitution relative (ne débutant pas par un slash ou un nom de
		protocole) arrive à la fin d'un jeu de règles. Voir la directive
		<directive module="mod_rewrite">RewriteBase</directive> pour plus de
		détails à propos de l'ajout du préfixe après les substitutions
		relatives.</li>

		<li>Si vous souhaitez effectuer une comparaison en prenant en compte
		l'intégralité du
		chemin de l'URL dans un contexte de répertoire (htaccess), vous devez
		utiliser la variable <code>%{REQUEST_URI}</code> dans la directive
		<directive>RewriteCond</directive>.</li>

		<li>Le prefixe supprimé se termine toujours par un slash, ce qui
		signifie que la comparaison s'effectue avec une chaîne qui ne comporte
		<em>jamais</em> de slash de début. Ainsi, un <em>modèle</em> contenant
		<code>^/</code> ne correspondra jamais dans un contexte de répertoire.</li>

		<li>Bien que les règles de réécriture soient permises du point de vue de
		la syntaxe dans les sections <directive type="section"
		module="core">Location</directive> et <directive type="section"
		module="core">Files</directive>, elles n'y sont pas prises en compte, et
		n'y sont à priori d'aucune utilité.</li>
		</ul>
		</note>

		<p>Pour quelques conseils à propos des <glossary
		@@ -1131,15 +1219,16 @@ substitution !
		</td>
		</tr>
		<tr>
		<td>discardpathinfo\|DPI</td>
		<td>discardpath\|DPI</td>
		<td>Supprime la partie PATH_INFO de l'URI réécrit. <em><a
		href="../rewrite/flags.html#flag_dpi">détails
		...</a></em></td>
		</tr>
		<tr>
		<td>env\|E=<em>VAR</em>[:<em>VAL</em>]</td>
		<td>env\|E=[!]<em>VAR</em>[:<em>VAL</em>]</td>
		<td>Définit la variable d'environnement <em>VAR</em> (à la valeur
		<em>VAL</em> si elle est fournie). <em><a
		<em>VAL</em> si elle est fournie). La variante !<em>VAR</em>
		annule la définition de la variable <em>VAR</em>.<em><a
		href="../rewrite/flags.html#flag_e">détails ...</a></em></td>
		</tr>
		<tr>
		@@ -1257,49 +1346,6 @@ configuration du module <module>mod_userdir</module>.</p>

		<p> Ce développement n'est pas effectué si le drapeau <em>PT</em> est
		utilisé dans la directive <directive module="mod_rewrite">RewriteRule</directive></p>
		</note>

		<note><title>Réécritures dans le contexte de répertoire</title>

		<p>Le moteur de réécriture peut être utilisé dans les fichiers <a
		href="../howto/htaccess.html">.htaccess</a>. Pour activer le moteur de
		réécriture pour ces fichiers, vous devez préciser "<code>RewriteEngine
		On</code>" <strong>et</strong> "<code>Options FollowSymLinks</code>"
		doit être activé. Si votre administrateur a interdit la surcharge de
		<code>FollowSymLinks</code> pour un répertoire utilisateur, vous ne
		pouvez pas utiliser le moteur de réécriture. Cette restriction est
		nécessaire pour des raisons de sécurité.</p>

		<p>Lorsqu'on utilise le moteur de réécriture dans les fichiers
		<code>.htaccess</code>, le préfixe du répertoire (qui est
		toujours le même pour un répertoire donné) est automatiquement
		<em>supprimé</em> pour la comparaison du modèle et automatiquement
		<em>ajouté</em> une fois la substitution effectuée. Cette fonctionnalité
		est nécessaire pour de nombreux cas de réécriture ; sans elle, vous
		seriez obligé de tenir compte du répertoire parent pour la comparaison,
		ce qui n'est pas toujours
		possible. Il y a une exception : si une chaîne de substitution commence
		par <code>http://</code>, le préfixe du répertoire ne sera
		<strong>pas</strong> ajouté, et une redirection externe (ou le passage
		par un mandataire, si le drapeau <strong>P</strong> est utilisé) sera
		initiée. Voir la directive <directive
		module="mod_rewrite">RewriteBase</directive> pour plus de détails.</p>

		<p>Le moteur de réécriture peut aussi être utilisé dans les sections
		<directive type="section" module="core">Directory</directive> avec les
		mêmes règles de comparaison des préfixes que celles qui s'appliquent
		pour les fichiers <code>.htaccess</code>. Cependant, il est en général
		plus simple, pour éviter la complication des substitutions de préfixes,
		de définir les règles de réécriture dans le contexte du serveur
		principal ou des hôtes virtuels, plutôt que dans une section
		<directive type="section" module="core">Directory</directive>.</p>

		<p>Bien que du point de vue syntaxique, il soit permis de définir des
		règles de réécriture dans les sections <directive type="section"
		module="core">Location</directive> et <directive
		type="section" module="core">Files</directive>, ce n'est à priori
		d'aucune utilité et n'est pas supporté.</p>

		</note>

		<p>Voici toutes les combinaisons de substitution et leurs

docs/manual/rewrite/flags.xml.fr

+10 −2

Changes for docs/manual/rewrite/flags.xml.fr: 10 added lines, 2 removed lines.
Original line number	Diff line number	Diff line
		<?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 : 1043126 -->
		<!-- English Revision : 1053726 -->
		<!-- French translation : Lucien GENTIS -->
		<!-- Reviewed by : Vincent Deffontaines -->

		@@ -226,7 +226,7 @@ fonctionnement des variables d'environnement.</p>
		<p>La syntaxe complète pour ce drapeau est :</p>

		<example>
		[E=VAR:VAL]
		[E=!VAR]
		</example>

		<p><code>VAL</code> peut comporter des références arrières
		@@ -241,6 +241,14 @@ fonctionnement des variables d'environnement.</p>
		<p>vous pouvez définir la variable d'environnement nommée
		<code>VAR</code> avec une valeur vide.</p>

		<p>La forme</p>

		<example>
		[E=!VAR]
		</example>

		<p>permet d'annuler la définition de la variable <code>VAR</code>.</p>

		<p>Les variables d'environnement s'emploient dans différents contextes,
		comme les programmes CGI, d'autres directives RewriteRule, ou des
		directives CustomLog.</p>