You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by pc...@apache.org on 2007/10/28 23:19:32 UTC
svn commit: r589431 [3/7] - /httpd/httpd/branches/2.2.x/docs/manual/
Added: httpd/httpd/branches/2.2.x/docs/manual/caching.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/caching.xml.fr?rev=589431&view=auto
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/caching.xml.fr (added)
+++ httpd/httpd/branches/2.2.x/docs/manual/caching.xml.fr Sun Oct 28 15:19:21 2007
@@ -0,0 +1,800 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="style/manual.fr.xsl"?>
+<!-- LastChangedRevision English document : 572620 -->
+<!-- French translation : Lucien GENTIS -->
+<!-- Reviewed by : Vincent Deffontaines -->
+<!-- $LastChangedRevision: 2008090501 $ -->
+
+<!--
+ 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="caching.xml.meta">
+
+ <title>Guide de la mise en cache</title>
+
+ <summary>
+ <p>Ce document complète la documentation de référence des modules
+ <module>mod_cache</module>,
+ <module>mod_disk_cache</module>, <module>mod_mem_cache</module>,
+ <module>mod_file_cache</module> et du programme <a
+ href="programs/htcacheclean.html">htcacheclean</a>.
+ Il décrit l'utilisation des fonctionnalités de mise en cache d'Apache
+ pour accélérer les services web et proxy, tout en évitant les problèmes
+ courants et les erreurs de configuration.</p>
+ </summary>
+
+ <section id="introduction">
+ <title>Introduction</title>
+
+ <p>Depuis la version 2.2 du serveur HTTP Apache, les modules
+ <module>mod_cache</module>
+ et <module>mod_file_cache</module> ne sont plus jugés expérimentaux
+ et on considère qu'ils peuvent être utilisés en production. Ces
+ architectures de mise en cache constituent un puissant concept
+ d'accélération de la gestion HTTP, tant comme serveur web originel
+ que comme mandataire.</p>
+
+ <p>Le module <module>mod_cache</module> et ses modules de soutien
+ <module>mod_mem_cache</module> et <module>mod_disk_cache</module>
+ permettent une mise en cache intelligente du point de vue HTTP.
+ Le contenu proprement dit est stocké dans le cache,
+ et mod_cache tente d'honorer tous les en-têtes HTTP et les options
+ qui définissent la possibilité de mise en cache du contenu. Il gère non
+ seulement le contenu local, mais aussi le contenu mandaté.
+ <module>mod_cache</module>
+ est conçu pour des configurations de mise en cache simples ou complexes,
+ dans lesquels vous traitez de contenu mandaté, de contenu local dynamique
+ ou avez besoin d'accélérer l'accès à des fichiers locaux qui sont modifiés
+ au cours du temps.</p>
+
+ <p>Le module <module>mod_file_cache</module> quant à lui, constitue une
+ forme de mise en cache plus basique, mais quelques fois intéressante.
+ Plutôt que de gérer la complexité de s'assurer de manière active de la
+ possibilité de mise en cache d'URLs,
+ <module>mod_file_cache</module> fournit des méthodes pour la gestion
+ et l'édition de fichiers en mémoire afin de maintenir un cache de fichiers
+ dans l'état où ils étaient la dernière fois qu'Apache a démarré.
+ En tant que tel, <module>mod_file_cache</module> a été conçu pour améliorer
+ le temps d'accès à des fichiers locaux statiques qui ne sont modifiés
+ que rarement.</p>
+
+ <p>Etant donné que <module>mod_file_cache</module> constitue une
+ implémentation de mise en cache relativement simple, mises à part les
+ sections spécifiques sur les directives <directive
+ module="mod_file_cache">CacheFile</directive> et <directive
+ module="mod_file_cache">MMapStatic</directive>, les explications fournies
+ dans ce guide concernent l'architecture de mise en cache du
+ module <module>mod_cache</module>.</p>
+
+ <p>Pour tirer parti efficacement de ce document, les bases de HTTP doivent
+ vous être familières, et vous devez avoir lu les sections
+ <a href="urlmapping.html">Mise en correspondance des
+ URLs avec le système de fichiers</a> et
+ <a href="content-negotiation.html">Négociation sur le contenu</a>
+ du guide de l'utilisateur.</p>
+
+ </section>
+
+ <section id="overview">
+
+ <title>Vue d'ensemble de la mise en cache</title>
+
+ <related>
+ <modulelist>
+ <module>mod_cache</module>
+ <module>mod_mem_cache</module>
+ <module>mod_disk_cache</module>
+ <module>mod_file_cache</module>
+ </modulelist>
+ <directivelist>
+ <directive module="mod_cache">CacheEnable</directive>
+ <directive module="mod_cache">CacheDisable</directive>
+ <directive module="mod_file_cache">MMapStatic</directive>
+ <directive module="mod_file_cache">CacheFile</directive>
+ <directive module="mod_file_cache">CacheFile</directive>
+ <directive module="core">UseCanonicalName</directive>
+ <directive module="mod_negotiation">CacheNegotiatedDocs</directive>
+ </directivelist>
+ </related>
+
+ <p><module>mod_cache</module> peut faire intervenir deux phases
+ principales pendant la durée de vie d'une requête.
+ En premier lieu, <module>mod_cache</module>
+ est un module de mise en correspondance d'URLs, ce qui signifie que si
+ une URL a été mise en cache, et que la version du cache de cette URL n'est
+ pas arrivée à expiration, la requête sera traitée directement par
+ <module>mod_cache</module>.</p>
+
+ <p>Ceci entraîne que toutes autres actions qui se dérouleraient normalement
+ au cours du processus de traitement d'une requête -- par exemple un
+ traitement effectué par <module>mod_proxy</module>, ou
+ <module>mod_rewrite</module> --
+ ne seront pas effectuées. Mais c'est justement l'intérêt
+ de la mise en cache préalable du contenu.</p>
+
+ <p>Si l'URL ne se trouve pas dans le cache, <module>mod_cache</module>
+ va ajouter un <a href="filter.html">filtre</a> au traitement de la requête.
+ Une fois le contenu de la réponse HTTP trouvé par Apache de manière classique, le
+ filtre sera exécuté en même temps que le contenu sera transmis au client.
+ S'il est déterminé que le contenu peut être mis en cache,
+ il sera sauvegardé dans le cache pour une utilisation future.</p>
+
+ <p>Si l'URL se trouve dans le cache, mais est arrivée à expiration,
+ le filtre est quand-même ajouté, mais <module>mod_cache</module> va créer
+ une requête conditionnelle en arrière-plan, pour déterminer si la version
+ du cache est encore à jour. Si la version du cache est encore à jour, ses
+ meta-informations seront mises à jour et la requête sera servie à partir du
+ cache. Si la version du contenu n'est plus à jour, elle sera supprimée et le
+ filtre va sauvegarder le contenu mis à jour dans le cache
+ au moment où il sera servi.</p>
+
+ <section>
+ <title>Amélioration du taux de présence dans le cache</title>
+
+ <p>Lors de la mise en cache de contenu généré localement, le
+ positionnement de la directive
+ <directive module="core">UseCanonicalName</directive> à
+ <code>On</code> peut améliorer de manière spectaculaire le taux de
+ présence dans le cache. Ceci est du au fait que le nom d'hôte de l'hôte
+ virtuel qui sert le contenu constitue une partie de la clé de cache.
+ Avec <directive module="core">UseCanonicalName</directive> positionnée
+ à <code>On</code>,
+ les hôtes virtuels possédant plusieurs noms de serveur ou alias ne
+ généreront pas d'entités de cache différentes, et le contenu sera mis en
+ cache en faisant référence au nom d'hôte canonique.</p>
+
+ <p>Les documents mis en cache ne seront servis qu'en réponse à des
+ requêtes de type URL, car la mise en cache est effectuée lors de la phase
+ de traduction de l'URL en nom de fichier.
+ En général, cela n'a que peu d'effet, à moins que vous n'utilisiez les
+ <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>
+ </example>
+
+ <p>Si vous utilisez les SSI, et voulez bénéficier de la vitesse de
+ service depuis le cache, vous devez utiliser des inclusions de type
+ <code>virtual</code>.</p>
+ </section>
+
+ <section>
+ <title>Périodes d'expiration</title>
+
+ <p>La période d'expiration par défaut pour les entités du cache est
+ d'une heure; elle peut cependant être facilement modifiée à l'aide de
+ la directive <directive
+ module="mod_cache">CacheDefaultExpire</directive>. Cette valeur par
+ défaut n'est utilisée que lorsque la source originale du contenu ne
+ précise pas de période d'expiration ou d'heure de dernière
+ modification.</p>
+
+ <p>Si une réponse ne contient pas d'en-tête <code>Expires</code> mais
+ inclut un en-tête <code>Last-Modified</code>, <module>mod_cache</module>
+ peut déduire une période d'expiration en se basant sur la valeur de la
+ directive <directive
+ module="mod_cache">CacheLastModifiedFactor</directive>.</p>
+
+ <p>La période d'expiration des contenus locaux peut être ajustée finement
+ en utilisant le module <module>mod_expires</module>.</p>
+
+ <p>On peut aussi contrôler la période d'expiration maximale en utilisant
+ la directive <directive module="mod_cache">CacheMaxExpire</directive>.</p>
+
+ </section>
+
+ <section>
+ <title>Guide succinct des requêtes conditionnelles</title>
+
+ <p>Lorsqu'un contenu est arrivé à expiration dans le cache et fait
+ l'objet d'une nouvelle demande d'accès, plutôt que traiter directement
+ la requête originale, Apache préfère utiliser une
+ requête conditionnelle.</p>
+
+ <p>HTTP propose toute une panoplie d'en-têtes qui permettent à un client,
+ ou au cache de distinguer les différentes versions d'un même contenu. Par
+ exemple, si une ressource a été servie avec un en-tête "Etag:", il est
+ possible de créer une requête conditionnelle contenant un en-tête
+ "If-None-Match:". Si une ressource a été servie avec un en-tête
+ "Last-Modified:", il est possible de créer une requête conditionnelle
+ contenant un en-tête "If-Modified-Since:", etc....</p>
+
+ <p>Lorsqu'une telle requête conditionnelle est créée, la reponse diffère
+ selon que le contenu satisfait ou non aux conditions. Si une requête est
+ créée avec un en-tête "If-Modified-Since:", et le contenu n'a pas été
+ modifié depuis le moment indiqué dans la requête, alors un laconique
+ "304 Not Modified" est retourné.</p>
+
+ <p>Si le contenu a été modifié, il est servi comme si la requête n'avait
+ pas été conditionnelle à l'origine.</p>
+
+ <p>Les bénéfices des requêtes conditionnelles pour ce qui concerne la
+ mise en cache sont de deux sortes. Premièrement, quand une telle requête
+ est envoyée au processus en arrière-plan, il sera aisé de déterminer
+ si le contenu que devra servir le processus en arrière-plan correspond
+ au contenu stocké dans le cache, sans être obligé de transmettre la
+ totalité de la ressource.</p>
+
+ <p>Deuxièmement, les requêtes conditionnelles sont en général moins
+ coûteuses en ressources pour le processus en arrière-plan.
+ Pour ce qui est des fichiers
+ statiques, l'action type est un appel à <code>stat()</code> ou un appel
+ système similaire, pour déterminer si la taille du fichier ou sa date de
+ modification ont changé. Ainsi, même si Apache met en cache le contenu
+ local, un contenu arrivé à expiration pourra être servi plus rapidement
+ depuis le cache s'il n'a pas été modifié, parce que la lecture depuis le
+ cache est plus rapide que la lecture depuis le processus en arrière-plan
+ (à comparer à la différence de vitesse entre la lecture depuis un cache en
+ mémoire et la lecture depuis un disque).</p>
+ </section>
+
+ <section>
+ <title>Que peut-on mettre en cache ?</title>
+
+ <p>Comme mentionné plus haut, les deux styles de mise en cache d'Apache
+ fonctionnent différemment; la mise en cache de
+ <module>mod_file_cache</module> conserve les contenus des fichiers
+ tels qu'ils étaient au démarrage d'Apache. Quand une requête pour un
+ fichier mis en cache par ce module est envoyée, elle est interceptée
+ et le fichier mis en cache est servi.</p>
+
+ <p>La mise en cache de <module>mod_cache</module>, quant à elle, est
+ plus complexe. Lors du traitement d'une requête, le module de mise en
+ cache déterminera si le contenu peut être mis en cache, s'il ne l'a
+ pas déjà été auparavant. Les conditions qui permettent de déterminer
+ la possibilité de mise en cache d'une réponse sont :</p>
+
+ <ol>
+ <li>La mise en cache doit être activée pour cette URL. Voir les
+ directives <directive
+ module="mod_cache">CacheEnable</directive> et <directive
+ module="mod_cache">CacheDisable</directive>.</li>
+
+ <li>La reponse doit avoir un code de statut HTTP de 200, 203, 300, 301
+ ou 410.</li>
+
+ <li>La requête doit être de type HTTP GET.</li>
+
+ <li>Si la requête contient un en-tête "Authorization:", la réponse ne
+ sera pas mise en cache.</li>
+
+ <li>Si la réponse contient un en-tête "Authorization:", elle doit aussi
+ contenir une option "s-maxage", "must-revalidate" ou "public"
+ dans l'en-tête "Cache-Control:".</li>
+
+ <li>Si l'URL contenait une requête sous forme de chaîne de caractères
+ (provenant par exemple d'une méthode GET de formulaire HTML), elle ne
+ sera pas mise en cache à moins que la réponse ne contienne un en-tête
+ "Expires:", comme précisé dans la RFC2616 section 13.9.</li>
+
+ <li>Si la réponse a un statut de 200 (OK), elle doit aussi contenir
+ au moins un des en-têtes "Etag", "Last-Modified" ou
+ "Expires", à moins que la directive
+ <directive module="mod_cache">CacheIgnoreNoLastMod</directive>
+ ne précise d'autres contraintes.</li>
+
+ <li>Si la réponse contient l'option "private" dans un en-tête
+ "Cache-Control:", elle ne sera pas mise en cache à moins que la
+ directive
+ <directive module="mod_cache">CacheStorePrivate</directive>
+ ne précise d'autres contraintes.</li>
+
+ <li>De même, si la réponse contient l'option "no-store" dans un en-tête
+ "Cache-Control:", elle ne sera pas mise en cache à moins que la
+ directive
+ <directive module="mod_cache">CacheStoreNoStore</directive>
+ n'ait été utilisée.</li>
+
+ <li>Une réponse ne sera pas mise en cache si elle comporte un en-tête
+ "Vary:" contenant le caractère "*" qui correspond à toute
+ chaîne de caractères.</li>
+ </ol>
+ </section>
+
+ <section>
+ <title>Qu'est ce qui ne doit pas être mis en cache ?</title>
+
+ <p>En bref, tout contenu qui varie beaucoup avec le temps, ou en fonction
+ de particularités de la requête qui ne sont pas couvertes par la
+ négociation HTTP, ne doit pas être mis en cache.</p>
+
+ <p>Un contenu dynamique qui varie en fonction de l'adresse IP du
+ demandeur, ou qui est modifié toutes les 5 minutes, ne devra en général
+ pas être mis en cache.</p>
+
+ <p>Si par contre le contenu servi diffère en fonction de la valeur de
+ divers en-têtes HTTP, il se peut que l'on puisse le mettre en cache
+ intelligemment en utilisant un en-tête "Vary".</p>
+ </section>
+
+ <section>
+ <title>Contenu variable et/ou négocié</title>
+
+ <p>Si <module>mod_cache</module> reçoit une réponse contenant un en-tête
+ "Vary", lorsqu'un contenu a été demandé par un processus d'arrière-plan,
+ il va s'efforcer de la traiter intelligemment. Si possible,
+ <module>mod_cache</module> va détecter les en-têtes attribués dans la
+ réponse "Vary" à l'occasion des futures demandes, et servir une réponse
+ correcte à partir du cache.</p>
+
+ <p>Si par exemple, une réponse est reçue avec l'en-tête Vary suivant,</p>
+
+ <example>
+Vary: negotiate,accept-language,accept-charset
+ </example>
+
+ <p><module>mod_cache</module> ne servira aux demandeurs que le contenu
+ mis en cache qui correspond au contenu des en-têtes accept-language et
+ accept-charset de la requête originale.</p>
+ </section>
+
+ </section>
+
+ <section id="security">
+ <title>Considérations sur la sécurité</title>
+
+ <section>
+ <title>Autorisation et contrôle d'accès</title>
+
+ <p>Utiliser <module>mod_cache</module> revient sensiblement à la même
+ chose qu'avoir un mandataire inverse intégré (reverse-proxy). Les requêtes
+ seront servies par le module de mise en cache sauf si ce dernier
+ détermine qu'un processus d'arrière-plan doit être appelé. La mise en
+ cache de ressources locales modifie considérablement le modèle de
+ sécurité d'Apache.</p>
+
+ <p>Comme le parcours de la hiérarchie d'un système de fichiers pour
+ examiner le contenu d'éventuels fichiers
+ <code>.htaccess</code> serait une opération très coûteuse en ressources,
+ annulant partiellement de ce fait l'intérêt de la mise en cache
+ (accélérer le traitement des requêtes),
+ <module>mod_cache</module> ne se préoccupe pas de savoir s'il a
+ l'autorisation de servir une entité mise en cache. En d'autres termes,
+ si <module>mod_cache</module> a mis en cache un certain contenu, ce
+ dernier sera servi à partir du cache tant qu'il ne sera pas arrivé à
+ expiration.</p>
+
+ <p>Si par exemple, votre configuration autorise l'accès à une ressource
+ en fonction de l'adresse IP, vous devez vous assurer que ce contenu n'est
+ pas mis en cache. Ceci est possible en utilisant la directive
+ <directive module="mod_cache">CacheDisable</directive>, ou le module
+ <module>mod_expires</module>. Livré à lui-même,
+ <module>mod_cache</module> - pratiquement comme un mandataire inverse -
+ mettrait en cache le contenu lors de son service, et le servirait ensuite
+ à tout client, vers n'importe quelle adresse IP.</p>
+ </section>
+
+ <section>
+ <title>Piratages locaux</title>
+
+ <p>Etant donné que les requêtes des utilisateurs finaux peuvent être
+ servies depuis le cache, ce dernier est une cible potentielle pour ceux
+ qui veulent défigurer un contenu ou interférer avec lui. Il est important
+ de garder à l'esprit que l'utilisateur sous lequel tourne Apache doit
+ toujours avoir l'accès en écriture dans le cache. Ceci est en contraste
+ total avec la recommandation usuelle d'interdire à l'utilisateur sous
+ lequel tourne Apache
+ l'accès en écriture à tout contenu.</p>
+
+ <p>Si l'utilisateur sous lequel tourne Apache est compromis,
+ par exemple à cause d'une
+ faille de sécurité dans un processus CGI, il est possible que le cache
+ fasse l'objet d'une attaque. Il est relativement aisé d'insérer ou de
+ modifier une entité dans le cache en utilisant le module
+ <module>mod_disk_cache</module>.</p>
+
+ <p>Cela représente un risque relativement élévé par rapport aux autres
+ types d'attaques qu'il est possible de mener sous l'utilisateur apache.
+ Si vous utilisez <module>mod_disk_cache</module>, vous devez garder ceci
+ à l'esprit : effectuez toujours les mises à jour d'Apache quand des
+ correctifs de sécurité sont annoncés et exécutez les processus CGI sous
+ un utilisateur autre qu'apache en utilisant
+ <a href="suexec.html">suEXEC</a> dans la mesure du possible.</p>
+
+ </section>
+
+ <section>
+ <title>Empoisonnement du cache (Cache Poisoning)</title>
+
+ <p>Si vous utilisez Apache comme serveur mandataire avec mise en cache,
+ vous vous exposez aussi à un éventuel "Empoisonnement du
+ cache" (Cache poisoning). L'empoisonnement du cache est un terme général
+ pour désigner les attaques au cours desquelles l'attaquant fait en sorte
+ que le serveur mandataire renvoie un contenu incorrect (et souvent
+ indésirable) en provenance du serveur d'arrière plan.
+ </p>
+
+ <p>Par exemple, si les serveur DNS qu'utilise votre système où tourne
+ Apache sont vulnérables à l'empoisonnement du cache des DNS, un attaquant
+ pourra contrôler vers où Apache se connecte lorsqu'il demande un contenu
+ depuis le serveur d'origine.
+ Un autre exemple est constitué par les attaques ainsi nommées
+ "Dissimulation de requêtes HTTP" (HTTP request-smuggling).</p>
+
+ <p>Ce document n'est pas le bon endroit pour une discussion approfondie
+ à propos de la Dissimulation de requêtes HTTP (utilisez plutôt votre
+ moteur de recherche favori); il est cependant important de savoir qu'il
+ est possible d'élaborer une série de requêtes, et d'exploiter une
+ vulnérabilité d'un serveur web d'origine de telle façon que l'attaquant
+ puisse contrôler entièrement le contenu renvoyé par le mandataire.</p>
+ </section>
+ </section>
+
+ <section id="filehandle">
+ <title>Mise en cache de la gestion de fichier</title>
+
+ <related>
+ <modulelist>
+ <module>mod_file_cache</module>
+ <module>mod_mem_cache</module>
+ </modulelist>
+ <directivelist>
+ <directive module="mod_file_cache">CacheFile</directive>
+ <directive module="mod_cache">CacheEnable</directive>
+ <directive module="mod_cache">CacheDisable</directive>
+ </directivelist>
+ </related>
+
+ <p>Le fait d'ouvrir un fichier peut en lui-même introduire un délai,
+ en particulier dans les systèmes de fichiers répartis sur le réseau. Apache
+ peut s'affranchir de ce délai en maintenant
+ un cache des descripteurs de fichiers
+ ouverts pour ce qui concerne les fichiers souvent accédés. Apache propose
+ actuellement deux implémentations différentes de mise en cache de la
+ gestion de fichier.</p>
+
+ <section>
+ <title>Directive CacheFile</title>
+
+ <p>La forme la plus élémentaire de mise en cache que propose Apache est
+ fournie par le module <module>mod_file_cache</module>.
+ Plutôt que de mettre en cache le contenu des fichiers, ce cache maintient
+ une table des descripteurs de fichiers ouverts. Les fichiers à mettre en
+ cache de cette manière sont spécifiés dans le fichier de configuration
+ en utilisant la directive
+ <directive module="mod_file_cache">CacheFile</directive>.</p>
+
+ <p>La directive
+ <directive module="mod_file_cache">CacheFile</directive> demande à Apache
+ d'ouvrir le fichier lors de son démarrage et de réutiliser le descripteur
+ de fichier élaboré à cette occasion pour tous les
+ accès ultérieurs à ce fichier.</p>
+
+ <example>
+ <pre>CacheFile /usr/local/apache2/htdocs/index.html</pre>
+ </example>
+
+ <p>Si vous avez l'intention de mettre en cache un grand nombre de
+ fichiers de cette manière, vous devez vous assurer que le nombre maximum
+ de fichiers ouverts par votre système d'exploitation est correctement
+ défini.</p>
+
+ <p>Bien que l'utilisation de la directive
+ <directive module="mod_file_cache">CacheFile</directive>
+ n'entraîne pas la mise en cache du contenu du fichier, cela ne signifie
+ pas qu'en cas de modification du fichier pendant l'exécution d'Apache,
+ ces changements seront pris en compte. Le fichier sera toujours servi
+ dans l'état où il était quand Apache a démarré.</p>
+
+ <p>Si le fichier est supprimé pendant l'exécution d'Apache, ce dernier
+ continuera à maintenir un descripteur de fichier ouvert et à servir le
+ fichier dans l'état où il était quand Apache a démarré. Cela signifie
+ aussi habituellement que malgré le fait que le fichier ait été supprimé,
+ et ne soit
+ plus accessible par le système de fichiers, l'espace libéré ne sera
+ restitué qu'à l'arrêt d'Apache quand le
+ descripteur de fichier sera fermé.</p>
+ </section>
+
+ <section>
+ <title>Directive CacheEnable</title>
+
+ <p>Le module <module>mod_mem_cache</module> propose aussi son propre
+ schéma de mise en cache de la gestion de fichier, qui peut être activé
+ à l'aide de la directive
+ <directive module="mod_cache">CacheEnable</directive>.</p>
+
+ <example>
+ <pre>CacheEnable fd /</pre>
+ </example>
+
+ <p>A l'instar de tout ce qui concerne le module
+ <module>mod_cache</module>, ce mode de mise en cache de la gestion de
+ fichier est intelligent, et les descripteurs ne seront plus maintenus
+ lorsque le contenu mis en cache sera arrivé à expiration.</p>
+ </section>
+ </section>
+
+ <section id="inmemory">
+ <title>Mise en cache en mémoire</title>
+
+ <related>
+ <modulelist>
+ <module>mod_mem_cache</module>
+ <module>mod_file_cache</module>
+ </modulelist>
+ <directivelist>
+ <directive module="mod_cache">CacheEnable</directive>
+ <directive module="mod_cache">CacheDisable</directive>
+ <directive module="mod_file_cache">MMapStatic</directive>
+ </directivelist>
+ </related>
+
+ <p>Servir un contenu directement depuis la mémoire système est
+ universellement reconnu comme la méthode la plus rapide. Lire des fichiers
+ depuis un contrôleur de disque ou pire, depuis un réseau distant est plus
+ lent de plusieurs ordres de grandeur. Les contrôleurs de disque réalisent
+ en général des opérations mécaniques, et l'accès au réseau est limité par la
+ bande passante dont vous disposez. Par contre, les temps d'accès à la
+ mémoire sont de l'ordre de la nano-seconde.</p>
+
+ <p>Cependant la mémoire système n'est pas bon marché; à capacité égale,
+ c'est de loin le type de stockage le plus coûteux et il est important de
+ s'assurer qu'elle est utilisée efficacement. Le fait de mettre en cache
+ des fichiers en mémoire diminue d'autant la quantité de mémoire système
+ disponible. Comme nous le verrons plus loin, ce n'est pas un problème en
+ soi dans le cas de la mise en cache par l'intermédiaire du système
+ d'exploitation, mais si l'on utilise la mise en cache en mémoire propre à
+ Apache, il faut prendre garde à ne pas allouer trop de mémoire au cache.
+ Sinon le système sera contraint d'utiliser le swap, ce qui dégradera
+ sensiblement les performances.</p>
+
+ <section>
+ <title>Mise en cache par l'intermédiaire du système d'exploitation</title>
+
+ <p>Dans la plupart des systèmes d'exploitation modernes, c'est le noyau
+ qui gère directement la mise en cache en mémoire des données relatives
+ aux fichiers. C'est une fonctionnalité puissante, et les systèmes
+ d'exploitation s'en acquittent fort bien pour la plus grande partie.
+ Considérons par exemple, dans le cas de Linux, la différence entre le
+ temps nécessaire à la première lecture d'un fichier et le temps
+ nécessaire à sa deuxième lecture;</p>
+
+ <example><pre>
+colm@coroebus:~$ time cat testfile > /dev/null
+real 0m0.065s
+user 0m0.000s
+sys 0m0.001s
+colm@coroebus:~$ time cat testfile > /dev/null
+real 0m0.003s
+user 0m0.003s
+sys 0m0.000s</pre>
+ </example>
+
+ <p>Même pour ce petit fichier, il y a une grande différence entre les
+ temps nécessaires pour lire le fichier. Ceci est du au fait que le
+ noyau a mis en cache le contenu du fichier en mémoire.</p>
+
+ <p>Du fait de toujours pouvoir disposer de mémoire système, vous pouvez
+ être assuré qu'il y aura de plus en plus de contenus de fichiers stockés
+ dans ce cache. Ceci peut s'avérer une méthode de mise en cache en mémoire
+ très efficace, et ne nécessite aucune configuration supplémentaire
+ d'Apache.</p>
+
+ <p>De plus, comme le système d'exploitation sait si des fichiers
+ ont été
+ supprimés ou modifiés, il peut effacer automatiquement des contenus de
+ fichiers du cache lorsque cela s'avère nécessaire. Ceci constitue un gros
+ avantage par rapport à la mise en cache en mémoire d'Apache qui n'a
+ aucune possibilité de savoir si un fichier a été modifié.</p>
+ </section>
+
+ <p>En dépit des performances et des avantages de la mise en cache
+ automatique par le système d'exploitation, la mise en cache en mémoire
+ peut être effectuée plus efficacement par Apache dans certaines
+ circonstances.</p>
+
+ <p>En premier lieu, un système d'exploitation ne peut mettre en cache que
+ les fichiers dont il a connaissance. Si vous exécutez Apache en tant que
+ serveur mandataire, les fichiers que vous mettez en cache ne sont pas
+ stockés en local mais sur un serveur distant. Si vous voulez tout de même
+ bénéficier de la vitesse incomparable procurée par la mise en cache en
+ mémoire, la mise en cache propre à Apache sera nécessaire.</p>
+
+ <section>
+ <title>Mise en cache à l'aide de la directive MMapStatic</title>
+
+ <p>La directive <directive module="mod_file_cache">MMapStatic</directive>
+ fournie par le module <module>mod_file_cache</module> vous permet de
+ demander à Apache de charger un contenu de fichier statique en mémoire
+ lors de son démarrage (à l'aide de l'appel système mmap). Apache
+ utilisera le contenu chargé en mémoire pour satisfaire ultérieurement
+ toutes les demandes d'accès à ce fichier.</p>
+
+ <example>
+ <pre>MMapStatic /usr/local/apache2/htdocs/index.html</pre>
+ </example>
+
+ <p>Comme dans le cas de la directive
+ <directive module="mod_file_cache">CacheFile</directive>, toute
+ modification du fichier ne sera plus prise en compte par Apache une fois
+ ce dernier démarré.</p>
+
+ <p> La directive
+ <directive module="mod_file_cache">MMapStatic</directive> ne gardant
+ pas la trace de la quantité de mémoire qu'elle alloue, vous devez prendre
+ garde de ne pas en abuser. Chaque processus enfant d'Apache utilisant
+ sa propre réplique de la mémoire allouée, il est donc d'une importance
+ critique de s'assurer que les fichiers chargés ne sont pas d'une taille
+ trop importante afin d'épargner au système l'utilisation du swap.</p>
+ </section>
+
+ <section>
+ <title>Mise en cache à l'aide du module mod_mem_cache</title>
+
+ <p>Le module <module>mod_mem_cache</module> propose une mise en cache en
+ mémoire intelligente du point de vue du protocole HTTP. Il utilise aussi
+ directement le "tas" de la mémoire, ce qui signifie que même si
+ <var>MMap</var> n'est pas supporté par votre système,
+ <module>mod_mem_cache</module> pourra quand-même effectuer
+ la mise en cache.</p>
+
+ <p>La mise en cache selon cette méthode est activée comme suit :</p>
+
+ <example><pre>
+# Activation de la mise en cache en mémoire
+CacheEnable mem /
+
+# Limite la taille du cache à 1 Mégaoctet
+MCacheSize 1024</pre>
+ </example>
+ </section>
+ </section>
+
+ <section id="disk">
+ <title>Mise en cache sur disque</title>
+
+ <related>
+ <modulelist>
+ <module>mod_disk_cache</module>
+ </modulelist>
+ <directivelist>
+ <directive module="mod_cache">CacheEnable</directive>
+ <directive module="mod_cache">CacheDisable</directive>
+ </directivelist>
+ </related>
+
+ <p>Le module <module>mod_disk_cache</module> fournit un mécanisme de mise
+ en cache sur disque au module <module>mod_cache</module>. Comme dans le cas
+ du module <module>mod_mem_cache</module>, cette mise en cache est
+ intelligente et le contenu ne sera servi qu'à partir du cache tant qu'il
+ sera considéré comme valide.</p>
+
+ <p>Typiquement, le module sera configuré comme suit :</p>
+
+ <example>
+ <pre>
+CacheRoot /var/cache/apache/
+CacheEnable disk /
+CacheDirLevels 2
+CacheDirLength 1</pre>
+ </example>
+
+ <p>Il est important de savoir que, les fichiers mis en cache étant stockés
+ localement, la mise en cache par l'intermédiaire du système d'exploitation
+ sera en général aussi appliquée à leurs accès. Si bien que même si les
+ fichiers sont stockés sur disque, s'il font l'objet d'accès fréquents,
+ il est probable que le système d'exploitation s'appliquera à ce qu'ils
+ soient servis à partir de la mémoire.</p>
+
+ <section>
+ <title>Comprendre le stockage dans le cache</title>
+
+ <p>Pour stocker des entités dans le cache,
+ le module <module>mod_disk_cache</module> crée une empreinte (hash) de 22
+ caractères de l'URL qui a fait l'objet d'une requête. Cette empreinte
+ comprend le nom d'hôte, le protocole, le port, le chemin et tout argument
+ de type CGI associé à l'URL, afin d'être sur que plusieurs URLs
+ n'interfèrent pas entre elles.</p>
+
+ <p>Chaque position de l'empreinte peut contenir un caractère
+ choisi parmi 64 caractères différents, il y a donc
+ 64^22 possibilités pour une empreinte. Par exemple, une URL peut posséder
+ l'empreinte <code>xyTGxSMO2b68mBCykqkp1w</code>. Cette empreinte est
+ utilisée pour préfixer les noms de fichiers spécifiques à cette URL à
+ l'intérieur du cache; cependant, elle est tout d'abord placée dans les
+ répertoires du cache selon les directives
+ <directive module="mod_disk_cache">CacheDirLevels</directive> et
+ <directive module="mod_disk_cache">CacheDirLength</directive>.</p>
+
+ <p>La directive
+ <directive module="mod_disk_cache">CacheDirLevels</directive>
+ définit le nombre de niveaux de sous-répertoires, et
+ <directive module="mod_disk_cache">CacheDirLength</directive>
+ le nombre de caractères composant le nom des sous-répertoires. Dans
+ l'exemple donné plus haut, l'empreinte se trouvera à :
+ <code>/var/cache/apache/x/y/TGxSMO2b68mBCykqkp1w</code>.</p>
+
+ <p>Cette technique a pour but principal de réduire le nombre de
+ sous-répertoires ou de fichiers contenus dans un répertoire particulier,
+ car le fonctionnement de la plupart des systèmes de fichiers est ralenti
+ quand ce nombre augmente. Avec la valeur "1" pour la directive
+ <directive module="mod_disk_cache">CacheDirLength</directive>,
+ il peut y avoir au plus 64 sous-répertoires à un niveau quelconque.
+ Avec la valeur "2", il peut y en avoir 64 * 64, etc...
+ A moins d'avoir une bonne raison pour ne pas le faire, l'utilisation de
+ la valeur "1" pour la directive
+ <directive module="mod_disk_cache">CacheDirLength</directive>
+ est recommandée.</p>
+
+ <p>Le paramétrage de la directive
+ <directive module="mod_disk_cache">CacheDirLevels</directive>
+ dépend du nombre de fichiers que vous pensez stocker dans le cache.
+ Avec une valeur de "2" comme dans l'exemple donné plus haut,
+ 4096 sous-répertoires peuvent être créés au total. Avec 1 million de
+ fichiers dans le cache, cela équivaut à environ 245 URLs mises en cache
+ dans chaque répertoire.</p>
+
+ <p>Chaque URL nécessite au moins deux fichiers dans le cache. Ce sont en
+ général un fichier ".header", qui contient des meta-informations à propos
+ de l'URL, comme la date de son arrivée à expiration,
+ et un fichier ".data" qui est la copie exacte du contenu à servir.</p>
+
+ <p>Dans le cas d'un contenu négocié via l'en-tête "Vary", un répertoire
+ ".vary" sera créé pour l'URL en question. Ce répertoire contiendra de
+ multiples fichiers ".data" correspondant aux différents contenus
+ négociés.</p>
+ </section>
+
+ <section>
+ <title>Maintenance du cache sur disque</title>
+
+ <p>Bien que le module <module>mod_disk_cache</module> supprime un contenu
+ du cache lorsqu'il est arrivé à expiration, il ne maintient aucune
+ information à propos de la taille totale du cache ou de l'espace restant
+ disponible.</p>
+
+ <p>Par contre l'utilitaire
+ <a href="programs/htcacheclean.html">htcacheclean</a> fourni avec Apache
+ vous permet, comme son nom l'indique, de nettoyer le cache périodiquement.
+ Déterminer la fréquence à laquelle lancer <a
+ href="programs/htcacheclean.html">htcacheclean</a> et la taille souhaitée
+ pour le cache est une tâche relativement complexe et il vous faudra de
+ nombreux essais et erreurs pour arriver à sélectionner des valeurs
+ optimales.</p>
+
+ <p><a href="programs/htcacheclean.html">htcacheclean</a> opère selon deux
+ modes. Il peut s'exécuter comme démon résident, ou être lancé
+ périodiquement par cron. <a
+ href="programs/htcacheclean.html">htcacheclean</a> peut mettre une heure
+ ou plus pour traiter de très grands caches (plusieurs dizaines de
+ Gigaoctets) et si vous l'exécutez à partir de cron, il vous est
+ conseillé de déterminer la durée typique d'un traitement, afin d'éviter
+ d'exécuter plusieurs instances à la fois.</p>
+
+ <p class="figure">
+ <img src="images/caching_fig1.gif" alt="" width="600"
+ height="406" /><br />
+ <a id="figure1" name="figure1"><dfn>Figure 1</dfn></a>: Croissance
+ typique du cache / séquence de nettoyage.</p>
+
+ <p>Comme <module>mod_disk_cache</module> ne tient pas compte de l'espace
+ utilisé dans le cache, vous devez vous assurer que
+ <a href="programs/htcacheclean.html">htcacheclean</a> est configuré de
+ façon à laisser suffisamment d'"espace de croissance"
+ à la suite d'un nettoyage.</p>
+ </section>
+
+ </section>
+
+</manualpage>
Propchange: httpd/httpd/branches/2.2.x/docs/manual/caching.xml.fr
------------------------------------------------------------------------------
svn:eol-style = native
Modified: httpd/httpd/branches/2.2.x/docs/manual/caching.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/caching.xml.meta?rev=589431&r1=589430&r2=589431&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/caching.xml.meta (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/caching.xml.meta Sun Oct 28 15:19:21 2007
@@ -7,5 +7,6 @@
<variants>
<variant>en</variant>
+ <variant>fr</variant>
</variants>
</metafile>
Modified: httpd/httpd/branches/2.2.x/docs/manual/configuring.html
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/configuring.html?rev=589431&r1=589430&r2=589431&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/configuring.html (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/configuring.html Sun Oct 28 15:19:21 2007
@@ -6,6 +6,10 @@
Content-Language: en
Content-type: text/html; charset=ISO-8859-1
+URI: configuring.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
URI: configuring.html.ja.euc-jp
Content-Language: ja
Content-type: text/html; charset=EUC-JP
Modified: httpd/httpd/branches/2.2.x/docs/manual/configuring.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/configuring.html.en?rev=589431&r1=589430&r2=589431&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/configuring.html.en (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/configuring.html.en Sun Oct 28 15:19:21 2007
@@ -20,8 +20,9 @@
<div class="toplang">
<p><span>Available Languages: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/configuring.html" title="English"> en </a> |
-<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
-<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+<a href="./fr/configuring.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
+<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title=""> ja </a> |
+<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title=""> ko </a></p>
</div>
<p>This document describes the files used to configure the Apache
@@ -159,8 +160,9 @@
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/configuring.html" title="English"> en </a> |
-<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
-<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+<a href="./fr/configuring.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
+<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title=""> ja </a> |
+<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title=""> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2007 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="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>
Added: httpd/httpd/branches/2.2.x/docs/manual/configuring.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/configuring.html.fr?rev=589431&view=auto
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/configuring.html.fr (added)
+++ httpd/httpd/branches/2.2.x/docs/manual/configuring.html.fr Sun Oct 28 15:19:21 2007
@@ -0,0 +1,185 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!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="fr" xml:lang="fr"><head><!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+<title>Fichiers de configuration - Serveur Apache HTTP</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 href="./images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page"><div id="page-header">
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.2</p>
+<img alt="" src="./images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.2</a></div><div id="page-content"><div id="preamble"><h1>Fichiers de configuration</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
+<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="./fr/configuring.html" title="Français"> fr </a> |
+<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title=""> ja </a> |
+<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title=""> ko </a></p>
+</div>
+
+<p>Ce document décrit les fichiers utilisés pour configurer
+le Serveur HTTP Apache.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#main">Fichiers de configuration principaux</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#syntax">Syntaxe des fichiers de configuration</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#modules">Modules</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#scope">Portée des directives</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#htaccess">Fichiers .htaccess</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="main" id="main">Fichiers de configuration principaux</a></h2>
+
+ <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#include">Include</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code></li></ul></td></tr></table>
+
+ <p>La configuration d'Apache est effectuée en plaçant des <a href="mod/directives.html">directives</a> dans des fichiers de
+ configuration au format texte. Le fichier de configuration principal se nomme
+ en général
+ <code>httpd.conf</code>. La localisation de ce fichier est définie
+ à la compilation, mais peut être redéfinie à l'aide de l'option
+ de ligne de commande <code>-f</code>. En outre, d'autres fichiers de
+ configuration peuvent être ajoutés à l'aide de la directive
+ <code class="directive"><a href="./mod/core.html#include">Include</a></code>, et des caractères de
+ remplacement
+ peuvent être utilisés pour inclure de nombreux fichiers de configuration.
+ Des directives de tous types peuvent être placées dans chacun de ces fichiers
+ de configuration. Les modifications dans les fichiers de configuration
+ principaux ne sont prises en compte par Apache que lorsque le serveur
+ est démarré ou redémarré.</p>
+
+ <p>Le serveur lit aussi un fichier contenant les types de document mime;
+ ce fichier est défini par la directive <code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code>,
+ et se nomme <code>mime.types</code> par défaut.</p>
+ </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="syntax" id="syntax">Syntaxe des fichiers de configuration</a></h2>
+
+
+ <p>Les fichiers de configuration d'Apache contiennent une directive
+ par ligne.
+ On peut utiliser l'anti-slash "\" comme dernier caractère d'une ligne
+ pour indiquer que la directive continue à la ligne suivante.
+ Il ne doit y avoir aucun caractère ni espace entre l'anti-slash et
+ la fin de la ligne.</p>
+
+ <p>Les directives dans les fichiers de configuration ne sont pas
+ sensibles à la casse, mais leurs arguments le sont souvent. Les lignes
+ qui débutent par le caractère "#" sont interprétées comme des
+ commentaires, et sont ignorées. Les commentaires ne doivent
+ <strong>pas</strong> être inclus dans une ligne après une directive
+ de configuration. Les lignes vides et les espaces précédant une directive
+ sont ignorés; vous pouvez par conséquent indenter les directives
+ afin d'améliorer la lisibilité.</p>
+
+ <p>Vous pouvez vérifier l'absence d'erreurs de syntaxe dans vos fichiers
+ de configuration sans démarrer le serveur à l'aide de la commande
+ <code>apachectl configtest</code> ou de l'option de ligne de commande
+ <code>-t</code>.</p>
+ </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="modules" id="modules">Modules</a></h2>
+
+
+ <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
+
+ <p>Apache est un serveur modulaire. Ceci implique que seules les
+ fonctionnalités les plus courantes sont incluses dans le serveur de base.
+ Les fonctionnalités étendues sont fournies à l'aide de <a href="mod/">modules</a> qui peuvent être chargés dans Apache.
+ Par défaut, un jeu de <a href="mod/module-dict.html#Status">modules de base</a> est inclus dans le
+ serveur à la compilation. Si le serveur est compilé de façon à utiliser
+ les <a href="dso.html">modules chargés dynamiquement</a>,
+ alors les modules peuvent être compilés séparément et chargés à
+ n'importe quel moment à l'aide de la directive
+ <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>.
+ Dans le cas contraire, Apache doit être recompilé pour ajouter ou
+ supprimer des modules.
+ Les directives de configuration peuvent être incluses de manière
+ conditionnelle selon la présence ou l'absence d'un module particulier
+ en les plaçant dans un bloc <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>.</p>
+
+ <p>Pour voir quels modules ont été compilés avec le serveur,
+ vous pouvez utiliser l'option de ligne de commande <code>-l</code>.</p>
+ </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="scope" id="scope">Portée des directives</a></h2>
+
+
+ <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
+
+ <p>Les directives placées dans les fichiers de configuration principaux
+ s'appliquent au serveur dans son ensemble. Si vous souhaitez modifier la
+ configuration d'une partie du serveur seulement, vous pouvez limiter la
+ portée de vos directives en les plaçant dans une section
+ <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#files"><Files></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code>, ou <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>.
+ Ces sections limitent le champ d'application des directives qu'elles
+ contiennent à des URls ou des portions du système de fichiers particulières.
+ Elles peuvent aussi être imbriquées, ce qui permet
+ une configuration très fine.</p>
+
+ <p>Apache peut servir simultanément de nombreux sites web au travers des
+ <a href="vhosts/">Hôtes Virtuels</a>. La portée des directives peut ainsi
+ être limitée en les plaçant dans des sections
+ <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>,
+ afin qu'elles ne s'appliquent qu'aux requêtes
+ pour un site web particulier.</p>
+
+ <p>Bien que la plupart des directives puissent être placées dans
+ chacune de ces sections, certaines d'entre elles n'ont aucun sens
+ dans certains contextes.
+ Par exemple, les directives qui contrôlent la création des processus
+ n'ont de sens que dans le contexte du serveur principal. Pour déterminer
+ quelles directives peuvent être placées dans quelles sections, consultez
+ le <a href="mod/directive-dict.html#Context">Contexte</a> de la
+ directive. Pour plus d'informations, nous fournissons des détails dans
+ <a href="sections.html">Comment fonctionnent les sections Directory,
+ Location et Files</a>.</p>
+ </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="htaccess" id="htaccess">Fichiers .htaccess</a></h2>
+
+
+ <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
+
+ <p>Apache permet la gestion décentralisée de la configuration
+ via des fichiers spéciaux placés dans l'arborescence du site web.
+ Ces fichiers spéciaux se nomment en général <code>.htaccess</code>,
+ mais tout autre nom peut être spécifié à l'aide de la directive
+ <code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code>.
+ Les directives placées dans les fichiers <code>.htaccess</code>
+ s'appliquent au répertoire dans lequel vous avez placé le fichier,
+ ainsi qu'à tous ses sous-répertoires.
+ La syntaxe des fichiers <code>.htaccess</code> est la même que celle
+ des fichiers de configuration principaux. Comme les fichiers
+ <code>.htaccess</code> sont lus à chaque requête, les modifications de
+ ces fichiers prennent effet immédiatement.</p>
+
+ <p>Pour déterminer quelles directives peuvent être placées
+ dans les fichiers <code>.htaccess</code>, consultez le
+ <a href="mod/directive-dict.html#Context">Contexte</a> de la
+ directive. L'administrateur du serveur peut contrôler quelles
+ directives peuvent être placées dans les fichiers
+ <code>.htaccess</code> en définissant la directive
+ <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
+ dans les fichiers de configuration principaux.</p>
+
+ <p>Pour plus d'informations sur les fichiers <code>.htaccess</code>,
+ se référer au <a href="howto/htaccess.html">tutoriel .htaccess</a>.</p>
+ </div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
+<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="./fr/configuring.html" title="Français"> fr </a> |
+<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title=""> ja </a> |
+<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title=""> ko </a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2007 The Apache Software Foundation.<br />Authorisé sous <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="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file
Propchange: httpd/httpd/branches/2.2.x/docs/manual/configuring.html.fr
------------------------------------------------------------------------------
svn:eol-style = native
Added: httpd/httpd/branches/2.2.x/docs/manual/configuring.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/configuring.xml.fr?rev=589431&view=auto
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/configuring.xml.fr (added)
+++ httpd/httpd/branches/2.2.x/docs/manual/configuring.xml.fr Sun Oct 28 15:19:21 2007
@@ -0,0 +1,215 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
+<!-- LastChangedRevision English document : 421100 -->
+<!-- French translation : Lucien GENTIS -->
+<!-- Reviewed by : Vincent Deffontaines -->
+<!-- $LastChangedRevision: 2007072901 $ -->
+
+<!--
+ 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="configuring.xml.meta">
+
+ <title>Fichiers de configuration</title>
+
+<summary>
+<p>Ce document décrit les fichiers utilisés pour configurer
+le Serveur HTTP Apache.</p>
+</summary>
+
+ <section id="main">
+ <title>Fichiers de configuration principaux</title>
+ <related>
+ <modulelist>
+ <module>mod_mime</module>
+ </modulelist>
+ <directivelist>
+ <directive module="core" type="section">IfDefine</directive>
+ <directive module="core">Include</directive>
+ <directive module="mod_mime">TypesConfig</directive>
+ </directivelist>
+ </related>
+
+ <p>La configuration d'Apache est effectuée en plaçant des <a
+ href="mod/directives.html">directives</a> dans des fichiers de
+ configuration au format texte. Le fichier de configuration principal se nomme
+ en général
+ <code>httpd.conf</code>. La localisation de ce fichier est définie
+ à la compilation, mais peut être redéfinie à l'aide de l'option
+ de ligne de commande <code>-f</code>. En outre, d'autres fichiers de
+ configuration peuvent être ajoutés à l'aide de la directive
+ <directive module="core">Include</directive>, et des caractères de
+ remplacement
+ peuvent être utilisés pour inclure de nombreux fichiers de configuration.
+ Des directives de tous types peuvent être placées dans chacun de ces fichiers
+ de configuration. Les modifications dans les fichiers de configuration
+ principaux ne sont prises en compte par Apache que lorsque le serveur
+ est démarré ou redémarré.</p>
+
+ <p>Le serveur lit aussi un fichier contenant les types de document mime;
+ ce fichier est défini par la directive <directive
+ module="mod_mime">TypesConfig</directive>,
+ et se nomme <code>mime.types</code> par défaut.</p>
+ </section>
+
+ <section id="syntax">
+ <title>Syntaxe des fichiers de configuration</title>
+
+ <p>Les fichiers de configuration d'Apache contiennent une directive
+ par ligne.
+ On peut utiliser l'anti-slash "\" comme dernier caractère d'une ligne
+ pour indiquer que la directive continue à la ligne suivante.
+ Il ne doit y avoir aucun caractère ni espace entre l'anti-slash et
+ la fin de la ligne.</p>
+
+ <p>Les directives dans les fichiers de configuration ne sont pas
+ sensibles à la casse, mais leurs arguments le sont souvent. Les lignes
+ qui débutent par le caractère "#" sont interprétées comme des
+ commentaires, et sont ignorées. Les commentaires ne doivent
+ <strong>pas</strong> être inclus dans une ligne après une directive
+ de configuration. Les lignes vides et les espaces précédant une directive
+ sont ignorés; vous pouvez par conséquent indenter les directives
+ afin d'améliorer la lisibilité.</p>
+
+ <p>Vous pouvez vérifier l'absence d'erreurs de syntaxe dans vos fichiers
+ de configuration sans démarrer le serveur à l'aide de la commande
+ <code>apachectl configtest</code> ou de l'option de ligne de commande
+ <code>-t</code>.</p>
+ </section>
+
+ <section id="modules">
+ <title>Modules</title>
+
+ <related>
+ <modulelist>
+ <module>mod_so</module>
+ </modulelist>
+ <directivelist>
+ <directive module="core" type="section">IfModule</directive>
+ <directive module="mod_so">LoadModule</directive>
+ </directivelist>
+ </related>
+
+ <p>Apache est un serveur modulaire. Ceci implique que seules les
+ fonctionnalités les plus courantes sont incluses dans le serveur de base.
+ Les fonctionnalités étendues sont fournies à l'aide de <a
+ href="mod/">modules</a> qui peuvent être chargés dans Apache.
+ Par défaut, un jeu de <a
+ href="mod/module-dict.html#Status">modules de base</a> est inclus dans le
+ serveur à la compilation. Si le serveur est compilé de façon à utiliser
+ les <a href="dso.html">modules chargés dynamiquement</a>,
+ alors les modules peuvent être compilés séparément et chargés à
+ n'importe quel moment à l'aide de la directive
+ <directive module="mod_so">LoadModule</directive>.
+ Dans le cas contraire, Apache doit être recompilé pour ajouter ou
+ supprimer des modules.
+ Les directives de configuration peuvent être incluses de manière
+ conditionnelle selon la présence ou l'absence d'un module particulier
+ en les plaçant dans un bloc <directive
+ module="core" type="section">IfModule</directive>.</p>
+
+ <p>Pour voir quels modules ont été compilés avec le serveur,
+ vous pouvez utiliser l'option de ligne de commande <code>-l</code>.</p>
+ </section>
+
+ <section id="scope">
+ <title>Portée des directives</title>
+
+ <related>
+ <directivelist>
+ <directive module="core" type="section">Directory</directive>
+ <directive module="core" type="section">DirectoryMatch</directive>
+ <directive module="core" type="section">Files</directive>
+ <directive module="core" type="section">FilesMatch</directive>
+ <directive module="core" type="section">Location</directive>
+ <directive module="core" type="section">LocationMatch</directive>
+ <directive module="core" type="section">VirtualHost</directive>
+ </directivelist>
+ </related>
+
+ <p>Les directives placées dans les fichiers de configuration principaux
+ s'appliquent au serveur dans son ensemble. Si vous souhaitez modifier la
+ configuration d'une partie du serveur seulement, vous pouvez limiter la
+ portée de vos directives en les plaçant dans une section
+ <directive module="core"
+ type="section">Directory</directive>, <directive module="core"
+ type="section">DirectoryMatch</directive>, <directive module="core"
+ type="section">Files</directive>, <directive module="core"
+ type="section">FilesMatch</directive>, <directive module="core"
+ type="section">Location</directive>, ou <directive module="core"
+ type="section">LocationMatch</directive>.
+ Ces sections limitent le champ d'application des directives qu'elles
+ contiennent à des URls ou des portions du système de fichiers particulières.
+ Elles peuvent aussi être imbriquées, ce qui permet
+ une configuration très fine.</p>
+
+ <p>Apache peut servir simultanément de nombreux sites web au travers des
+ <a href="vhosts/">Hôtes Virtuels</a>. La portée des directives peut ainsi
+ être limitée en les plaçant dans des sections
+ <directive module="core" type="section">VirtualHost</directive>,
+ afin qu'elles ne s'appliquent qu'aux requêtes
+ pour un site web particulier.</p>
+
+ <p>Bien que la plupart des directives puissent être placées dans
+ chacune de ces sections, certaines d'entre elles n'ont aucun sens
+ dans certains contextes.
+ Par exemple, les directives qui contrôlent la création des processus
+ n'ont de sens que dans le contexte du serveur principal. Pour déterminer
+ quelles directives peuvent être placées dans quelles sections, consultez
+ le <a href="mod/directive-dict.html#Context">Contexte</a> de la
+ directive. Pour plus d'informations, nous fournissons des détails dans
+ <a href="sections.html">Comment fonctionnent les sections Directory,
+ Location et Files</a>.</p>
+ </section>
+
+ <section id="htaccess">
+ <title>Fichiers .htaccess</title>
+
+ <related>
+ <directivelist>
+ <directive module="core">AccessFileName</directive>
+ <directive module="core">AllowOverride</directive>
+ </directivelist>
+ </related>
+
+ <p>Apache permet la gestion décentralisée de la configuration
+ via des fichiers spéciaux placés dans l'arborescence du site web.
+ Ces fichiers spéciaux se nomment en général <code>.htaccess</code>,
+ mais tout autre nom peut être spécifié à l'aide de la directive
+ <directive module="core">AccessFileName</directive>.
+ Les directives placées dans les fichiers <code>.htaccess</code>
+ s'appliquent au répertoire dans lequel vous avez placé le fichier,
+ ainsi qu'à tous ses sous-répertoires.
+ La syntaxe des fichiers <code>.htaccess</code> est la même que celle
+ des fichiers de configuration principaux. Comme les fichiers
+ <code>.htaccess</code> sont lus à chaque requête, les modifications de
+ ces fichiers prennent effet immédiatement.</p>
+
+ <p>Pour déterminer quelles directives peuvent être placées
+ dans les fichiers <code>.htaccess</code>, consultez le
+ <a href="mod/directive-dict.html#Context">Contexte</a> de la
+ directive. L'administrateur du serveur peut contrôler quelles
+ directives peuvent être placées dans les fichiers
+ <code>.htaccess</code> en définissant la directive
+ <directive module="core">AllowOverride</directive>
+ dans les fichiers de configuration principaux.</p>
+
+ <p>Pour plus d'informations sur les fichiers <code>.htaccess</code>,
+ se référer au <a href="howto/htaccess.html">tutoriel .htaccess</a>.</p>
+ </section>
+</manualpage>
Propchange: httpd/httpd/branches/2.2.x/docs/manual/configuring.xml.fr
------------------------------------------------------------------------------
svn:eol-style = native
Modified: httpd/httpd/branches/2.2.x/docs/manual/configuring.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/configuring.xml.meta?rev=589431&r1=589430&r2=589431&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/configuring.xml.meta (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/configuring.xml.meta Sun Oct 28 15:19:21 2007
@@ -8,6 +8,7 @@
<variants>
<variant>de</variant>
<variant>en</variant>
+ <variant>fr</variant>
<variant>ja</variant>
<variant>ko</variant>
</variants>
Modified: httpd/httpd/branches/2.2.x/docs/manual/content-negotiation.html
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/content-negotiation.html?rev=589431&r1=589430&r2=589431&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/content-negotiation.html (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/content-negotiation.html Sun Oct 28 15:19:21 2007
@@ -2,6 +2,10 @@
Content-Language: en
Content-type: text/html; charset=ISO-8859-1
+URI: content-negotiation.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
URI: content-negotiation.html.ja.euc-jp
Content-Language: ja
Content-type: text/html; charset=EUC-JP
Modified: httpd/httpd/branches/2.2.x/docs/manual/content-negotiation.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/content-negotiation.html.en?rev=589431&r1=589430&r2=589431&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/content-negotiation.html.en (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/content-negotiation.html.en Sun Oct 28 15:19:21 2007
@@ -19,8 +19,9 @@
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.2</a></div><div id="page-content"><div id="preamble"><h1>Content Negotiation</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/content-negotiation.html" title="English"> en </a> |
-<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
-<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+<a href="./fr/content-negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
+<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title=""> ja </a> |
+<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title=""> ko </a></p>
</div>
@@ -671,8 +672,9 @@
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/content-negotiation.html" title="English"> en </a> |
-<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
-<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+<a href="./fr/content-negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
+<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title=""> ja </a> |
+<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title=""> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2007 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="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div>