Mode d'emploi succinct

Le support DSO pour le chargement de modules individuels d'Apache + httpd est assuré par un module nommé mod_so qui doit être compilé - statiquement dans le coeur d'Apache. Il s'agit du seul module avec le + statiquement dans le coeur d'Apache httpd. Il s'agit du seul module avec le module core à ne pas pouvoir être compilé en tant que - module DSO lui-même. Pratiquement tous les autres modules d'Apache + module DSO lui-même. Pratiquement tous les autres modules + d'Apache httpd distribués peuvent être compilés en tant que modules DSO en sélectionnant pour chacun d'entre eux le mode de construction DSO à l'aide de l'option - --enable-module=shared du script + --enable-mods-shared du script configure, comme décrit dans la Documentation de l'installation. Une fois compilé en tant que module DSO, un module peut être chargé en mémoire au @@ -70,19 +72,19 @@ mod_so, placée dans votre fichier httpd.conf.

Un nouvel utilitaire a été introduit afin de simplifier la création de - fichiers DSO pour les modules d'Apache +

Un utilitaire permet de simplifier la création de + fichiers DSO pour les modules d'Apache httpd (particulièrement pour les modules tiers) ; il s'agit du programme nommé apxs (APache eXtenSion). On peut l'utiliser pour construire des modules de type - DSO en dehors de l'arborescence des sources d'Apache. L'idée est - simple : à l'installation d'Apache, la procédure make install + DSO en dehors de l'arborescence des sources d'Apache httpd. L'idée est + simple : à l'installation du serveur HTTP Apache, la procédure make install du script configure installe les fichiers d'en-têtes - d'Apache et positionne, pour la plateforme de compilation, les drapeaux du compilateur et de + d'Apache httpd et positionne, pour la plateforme de compilation, les drapeaux du compilateur et de l'éditeur de liens à l'intérieur du programme apxs, qui sera utilisé pour la construction de fichiers DSO. Il est ainsi possible d'utiliser le programme apxs - pour compiler ses sources de modules Apache sans avoir besoin de + pour compiler ses sources de modules Apache httpd sans avoir besoin de l'arborescence des sources de la distribution d'Apache, et sans avoir à régler les drapeaux du compilateur et de l'éditeur de liens pour le support DSO.

Avantages et inconvénients @@ -269,22 +267,22 @@ $ apxs -i -a -n foo mod_foo.la configure à 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, PHP], etc...) à partir d'une seule installation - d'Apache. + [mod_perl, PHP3], etc...) à partir d'une seule installation + d'Apache httpd.
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 avantage pour les mainteneurs de paquetages destinés aux distributions, - car ils peuvent créer un paquetage Apache de base, et des paquetages + 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, etc...
-
Une facilité de prototypage des modules Apache car la paire +
Une facilité de prototypage des modules Apache httpd car la paire DSO/apxs vous permet d'une part de travailler en - dehors de l'arborescence des sources d'Apache, et d'autre part de n'avoir + dehors de l'arborescence des sources d'Apache httpd, et d'autre part de n'avoir besoin que de la commande apxs -i suivie d'un apachectl restart pour introduire une nouvelle - version de votre module fraîchement développé dans le serveur Apache + version de votre module fraîchement développé dans le serveur HTTP Apache en cours d'exécution.
@@ -313,13 +311,13 @@ $ apxs -i -a -n foo mod_foo.la ELF le font), vous ne pouvez pas utiliser le mécanisme DSO pour tous les types de modules. Ou en d'autres termes, les modules compilés comme fichiers DSO sont contraints de n'utiliser que les symboles du coeur - d'Apache, de la bibliothèque C + d'Apache httpd, de la bibliothèque C (libc) et toutes autres bibliothèques statiques ou - dynamiques utilisées par le coeur d'Apache, ou d'archives statiques + dynamiques utilisées par le coeur d'Apache httpd, ou d'archives statiques (libfoo.a) contenant du code indépendant de la position (PIC). Il y a deux solutions pour utiliser un autre type de code : soit le - coeur d'Apache contient déjà lui-même une référence au code, soit vous + coeur d'Apache httpd contient déjà lui-même une référence au code, soit vous chargez le code vous-même via dlopen(). Modified: httpd/httpd/trunk/docs/manual/install.xml.fr URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/install.xml.fr?rev=928468&r1=928467&r2=928468&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/install.xml.fr (original) +++ httpd/httpd/trunk/docs/manual/install.xml.fr Sun Mar 28 18:29:30 2010 @@ -3,7 +3,7 @@ - + + @@ -55,7 +55,8 @@ mobiliser des threads que pour les conne Lorsqu'un client a soumis une première requête, il peut garder la connexion ouverte, et envoyer les requêtes suivantes en utilisant le même socket. Ceci permet de réduire de manière significative la - surcharge due à la création de connexions TCP. Cependant, Apache + surcharge due à la création de connexions TCP. + Cependant, le serveur HTTP Apache mobilise en principe à cet effet un processus/thread enfant en attente des données du client, ce qui amène son propre lot d'inconvénients. Pour résoudre ce problème, event Modified: httpd/httpd/trunk/docs/manual/mod/index.xml.fr URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/index.xml.fr?rev=928468&r1=928467&r2=928468&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/mod/index.xml.fr (original) +++ httpd/httpd/trunk/docs/manual/mod/index.xml.fr Sun Mar 28 18:29:30 2010 @@ -1,7 +1,7 @@ - + @@ -27,8 +27,8 @@

Ci-dessous se trouve la liste de tous les modules qui font partie de - la distribution Apache. Voir aussi la liste alphabétique complète - de toutes les directives Apache. + la distribution du serveur HTTP Apache. Voir aussi la liste alphabétique complète + de toutes les directives du serveur HTTP Apache.

Modules multi-processus (MPMs) Modified: httpd/httpd/trunk/docs/manual/mod/mod_access_compat.xml.fr URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_access_compat.xml.fr?rev=928468&r1=928467&r2=928468&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/mod/mod_access_compat.xml.fr (original) +++ httpd/httpd/trunk/docs/manual/mod/mod_access_compat.xml.fr Sun Mar 28 18:29:30 2010 @@ -1,7 +1,7 @@ - + @@ -30,8 +30,9 @@ adresse IP) Extension mod_access_compat.c access_compat_module -Disponible dans Apache 2.3 à des fins de compatibilité -avec les précédentes versions d'Apache 2.x. Les directives fournies par +Disponible dans la version 2.3 du serveur HTTP Apache +à des fins de compatibilité +avec les précédentes versions d'Apache httpd 2.x. Les directives fournies par ce module sont devenues obsolètes depuis la refonte d'authz. Voir mod_authz_host @@ -125,7 +126,7 @@ d'environnement composantes entières du nom d'hôte doivent correspondre ; ainsi, dans l'exemple ci-dessus, foo.apache.org correspondra, mais fooapache.org ne conviendra pas. - Avec cette configuration, Apache va effectuer une double recherche + Avec cette configuration, Apache httpd va effectuer une double recherche DNS sur l'adresse IP du client, sans tenir compte de la définition de la directive HostnameLookups. Tout d'abord, une Modified: httpd/httpd/trunk/docs/manual/mod/mod_actions.xml.fr URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_actions.xml.fr?rev=928468&r1=928467&r2=928468&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/mod/mod_actions.xml.fr (original) +++ httpd/httpd/trunk/docs/manual/mod/mod_actions.xml.fr Sun Mar 28 18:29:30 2010 @@ -1,7 +1,7 @@ - + @@ -47,7 +47,7 @@ type de média ou de la mét mod_cgi Contenu dynamique avec CGI Utilisation des gestionnaires -d'Apache +d'Apache httpd Action Modified: httpd/httpd/trunk/docs/manual/mod/mod_asis.xml.fr URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_asis.xml.fr?rev=928468&r1=928467&r2=928468&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/mod/mod_asis.xml.fr (original) +++ httpd/httpd/trunk/docs/manual/mod/mod_asis.xml.fr Sun Mar 28 18:29:30 2010 @@ -1,7 +1,7 @@ - + @@ -33,7 +33,7 @@ HTTP

Ce module fournit le gestionnaire send-as-is qui - permet à Apache d'envoyer le document sans ajouter la plupart des + permet au serveur HTTP Apache d'envoyer le document sans ajouter la plupart des en-têtes HTTP habituels.

On peut l'utiliser pour envoyer tous types de données en @@ -47,7 +47,7 @@ HTTP mod_headers mod_cern_meta Utilisation des gestionnaires -d'Apache +d'Apache httpd

Mode d'emploi @@ -57,7 +57,7 @@ d'Apache AddHandler send-as-is asis
Le contenu de tout fichier possédant l'extension - .asis sera envoyé par Apache au client pratiquement tel + .asis sera envoyé par Apache httpd au client pratiquement tel quel. En particulier, les en-têtes HTTP seront déduits du fichier lui-même selon les règles du module mod_cgi, si bien qu'un fichier asis doit inclure des en-têtes valides, et @@ -70,7 +70,7 @@ d'Apache Status: 301 Ou se trouve cette URL maintenant
- Location: http://xyz.abc.com/foo/bar.html
+ Location: http://xyz.example.com/foo/bar.html
Content-type: text/html

<html>
@@ -79,7 +79,7 @@ d'Apache </head>
<body>
<h1>La merveilleuse page de Fred a été déplacée vers
- <a href="http://xyz.abc.com/foo/bar.html">le site de + <a href="http://xyz.example.com/foo/bar.html">le site de Joe</a>.
</h1>
</body>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.fr URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.fr?rev=928468&r1=928467&r2=928468&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.fr (original) +++ httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.fr Sun Mar 28 18:29:30 2010 @@ -1,7 +1,7 @@ - + @@ -82,7 +82,8 @@ shell Win32 dir Arguments de la requête d'autoindexation -
Apache 2.0.23 a réorganisé les arguments de requête pour le tri +
Le serveur HTTP Apache version 2.0.23 a réorganisé + les arguments de requête pour le tri des colonnes, et intoduit un groupe complet de nouvelles options de requête. Pour interdire effectivement au client tout contrôle sur l'affichage, l'option
Charset=jeu de caractères (Versions 2.0.61 et - supérieures d'Apache)
+ supérieures du serveur HTTP Apache

)
 
       Le mot-clé Charset vous permet de spécifier le
       jeu de caractères de la page générée. La valeur par défaut est
@@ -605,7 +606,7 @@ répertoire
       
DescriptionWidth=[n | *] (Versions 2.0.23 et
-      supérieures d'Apache)
+      supérieures du serveur HTTP Apache)
 
       Le mot-clé DescriptionWidth vous permet de
       spécifier la taille en caractères de la colonne description.
@@ -633,7 +634,7 @@ répertoire
 
       FoldersFirst (Versions 2.0.23 et
-      supérieures d'Apache)
+      supérieures du serveur HTTP Apache)
 
       Lorsque cette option est activée, la liste des
       sous-répertoires apparaîtra toujours en premier, suivie
@@ -652,7 +653,7 @@ répertoire
       
HTMLTable
 	       (Expérimental, versions 2.0.23 et supérieures
-	       d'Apache)
+	       du serveur HTTP Apache)
 
       Cette option expérimentale pour l'affichage
       FancyIndexing permet de construire une table simple
@@ -680,7 +681,7 @@ répertoire
       permettre au navigateur de prévoir les caractéristiques de la page
       sans devoir attendre que toutes les images aient été chargées. En
       l'absence de cette option, c'est la hauteur standard définie par
-      le logiciel Apache qui est choisie comme valeur par défaut.
+      le logiciel Apache httpd qui est choisie comme valeur par défaut.
 
       IconWidth[=
       permettre au navigateur de prévoir les caractéristiques de la page
       sans devoir attendre que toutes les images aient été chargées. En
       l'absence de cette option, c'est la largeur standard définie par
-      le logiciel Apache qui est choisie comme valeur par défaut.
+      le logiciel Apache httpd qui est choisie comme valeur par défaut.
 
       
IgnoreCase
@@ -746,7 +747,7 @@ répertoire
       ShowForbidden
 
-      Si cette option est activée, Apache affichera les fichiers
+      
Si cette option est activée, Apache httpd affichera les fichiers
       normalement cachés suite au retour des valeurs
       HTTP_UNAUTHORIZED ou HTTP_FORBIDDEN par
       la sous-requête.
@@ -755,15 +756,15 @@ répertoire
                id="indexoptions.suppresscolumnsorting"
                >SuppressColumnSorting
 
-      Si cette option est activée, Apache supprimera les liens
+      
Si cette option est activée, Apache httpd supprimera les liens
       hyper-texte dans les en-têtes de colonnes dans le cas d'un
       affichage "amélioré". Par défaut, ces en-têtes constituent des liens
       hyper-texte, et la sélection de l'un d'entre eux va trier l'index
       du répertoire en fonction des valeurs de la colonne
-      correspondante. Avant
-      Apache 2.0.23, cette option désactivait aussi l'interprétation des
+      correspondante. Avant la version 2.0.23 du serveur HTTP
+      Apache, cette option désactivait aussi l'interprétation des
       informations de tri transmises via les arguments de la
-      requête. Depuis Apache 2.0.23, ce comportement est
+      requête. Depuis la version 2.0.23 du serveur HTTP Apache, ce comportement est
       contrôlé par IndexOptions
       IgnoreClient.
@@ -803,7 +804,8 @@ répertoire
 
       SuppressIcon
-	       (Versions 2.0.23 et supérieures d'Apache)
+	       (Versions 2.0.23 et supérieures du serveur
+	       HTTP Apache)
 
       L'activation de cette option supprime l'affichage des icônes
       dans le cas d'un affichage "amélioré". La combinaison de
@@ -822,7 +824,7 @@ répertoire
 
       
SuppressRules
-      (Versions 2.0.23 et supérieures d'Apache)
+      (Versions 2.0.23 et supérieures du serveur HTTP Apache)
 
       L'activation de cette option supprime l'affichage des lignes
       horizontales (éléments hr) dans les index de
@@ -841,7 +843,8 @@ répertoire
 
       
TrackModified
-	       (Versions 2.0.23 et supérieures d'Apache)
+	       (Versions 2.0.23 et supérieures du serveur
+	       HTTP Apache)
 
       Cette option renvoie les valeurs Last-Modified et
       ETag pour le répertoire indexé dans l'en-tête HTTP.
@@ -865,7 +868,7 @@ répertoire
       
Type=type MIME (Versions 2.0.61 et
-      supérieures d'Apache)
+      supérieures du serveur HTTP Apache)
 
       Le mot-clé Type vous permet de spécifier le type
       MIME de la page générée. La valeur par défaut est
@@ -879,7 +882,7 @@ répertoire
 
       
VersionSort
-      (Apache 2.0a3 and later)
+      (Versions 2.0a3 et supérieures du serveur HTTP Apache)
 
       Le mot-clé VersionSort permet de trier les
       fichiers contenant des numéros de version d'une manière
@@ -909,7 +912,7 @@ répertoire
 
       
XHTML
-      (Versions 2.0.49 et supérieures d'Apache)
+      (Versions 2.0.49 et supérieures du serveur HTTP Apache)

Le mot-clé XHTML enjoint
       mod_autoindex de générer du code XHTML 1.0 au
@@ -922,7 +925,7 @@ répertoire
    -->

Options d'index incrémentales

-Les variables d'environnement dans -Apache +Les variables d'environnement et le +serveur HTTP Apache BrowserMatch @@ -98,9 +98,6 @@ casse virtual hostdirectory .htaccess FileInfo -Versions 1.2 d'Apache et supérieures (dans Apache 1.2, -cette directive se trouvait dans le module mod_browser devenu depuis -obsolète) @@ -226,7 +223,7 @@ peuvent se présenter sous les for seconde forme, la variable sera supprimée si elle a été définie au préalable, et dans la troisième forme, la variable sera définie à la valeur littérale spécifiée par valeur. Depuis - la version 2.0.51, Apache reconnaît les occurrences de variables + la version 2.0.51, Apache httpd reconnaît les occurrences de variables $1..$9 à l'intérieur de valeur, et les remplace par les sous-expressions entre parenthèses correspondantes de @@ -264,8 +261,8 @@ peuvent se présenter sous les for jeu [a-z].

-Les variables d'environnement dans -Apache pour des exemples supplémentaires. +Les variables d'environnement et le +serveur HTTP Apache pour des exemples supplémentaires. @@ -280,7 +277,6 @@ attributs de la requête sans tenir virtual hostdirectory .htaccess FileInfo -Versions 1.3 d'Apache et supérieures Modified: httpd/httpd/trunk/docs/manual/mod/mod_so.xml.fr URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_so.xml.fr?rev=928468&r1=928467&r2=928468&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/mod/mod_so.xml.fr (original) +++ httpd/httpd/trunk/docs/manual/mod/mod_so.xml.fr Sun Mar 28 18:29:30 2010 @@ -1,7 +1,7 @@ - + @@ -36,7 +36,7 @@ inclus)

Sur les systèmes d'exploitation sélectionnés, ce module peut être - utilisé pour charger des modules dans Apache en cours d'exécution + utilisé pour charger des modules dans le serveur HTTP Apache en cours d'exécution grâce au mécanisme des Dynamic Shared Object ou Objets Partagés Dynamiquement (DSO), et évite ainsi de devoir effectuer une @@ -48,9 +48,12 @@ inclus) .dll.

Avertissement -

Les modules Apache 1.3 ne peuvent pas être utilisés directement - avec Apache 2.0 - ils doivent être modifiés pour pouvoir être - chargés dynamiquement ou compilés dans Apache 2.0.

En général, les modules compilés pour une version majeure du + serveur HTTP Apache ne fonctionneront pas avec une autre (par + exemple de 1.3 à 2.0 ou 2.0 à 2.2). D'une version majeure à l'autre, + il y a souvent des modifications d'API qui nécessitent des + modifications du module pour qu'il puisse fonctionner avec la + nouvelle version.

@@ -59,8 +62,8 @@ Windows Note

Le format des noms de modules pour Windows a été modifié avec - Apache 1.3.15 et 2.0 - les modules possèdent maintenant un nom du - style "mod_foo.so".

+ les version 1.3.15 et 2.0 du serveur HTTP Apache - les modules + possèdent maintenant un nom du style "mod_foo.so".

Bien que mod_so puisse encore charger des modules possèdant un nom du style ApacheModuleFoo.dll, il est préférable d'utiliser la @@ -68,7 +71,7 @@ Windows chargeable pour la version 2.0, veuillez aussi modifier son nom pour respecter cette nouvelle convention.

Les API des modules Apache sous Unix et Windows sont identiques. +

Les API des modules Apache httpd sous Unix et Windows sont identiques. Alors que certains modules s'appuient sur certains aspects de l'architecture Unix non présents dans Windows, et ne fonctionneront donc pas sur cette dernière plate-forme, de nombreux @@ -77,8 +80,8 @@ Windows

Lorsqu'un module fonctionne, il peut être ajouté au serveur de deux manières. Sous Unix, il peut être compilé dans le serveur. - Comme Apache pour Windows ne dispose pas du programme - Configure propre à Apache pour Unix, le fichier source + Comme Apache httpd pour Windows ne dispose pas du programme + Configure propre à Apache httpd pour Unix, le fichier source du module doit être ajouté au fichier projet Apache de base, et ses symboles ajoutés au fichier os\win32\modules.c.

@@ -87,14 +90,14 @@ Windows serveur en cours d'exécution via la directive LoadModule. Ces modules DLL peuvent être distribués et exécutés sur toute installation d'Apache - pour Windows, sans avoir à recompiler le serveur.

+ httpd pour Windows, sans avoir à recompiler le serveur.

Pour créer un module DLL, il est nécessaire d'apporter une légère modification à son fichier source : l'enregistrement du module doit être exporté depuis la DLL (qui sera elle-même créée plus tard ; voir plus loin). Pour ce faire, ajoutez la macro AP_MODULE_DECLARE_DATA (définie dans les fichiers - d'en-têtes d'Apache) à la définition de l'enregistrement de votre + d'en-têtes d'Apache httpd) à la définition de l'enregistrement de votre module. Par exemple, si votre module est déclaré comme suit :

@@ -117,7 +120,7 @@ Windows d'export libhttpd.lib qui a été créée au cours de la compilation de la bibliothèque partagée libhttpd.dll. Il sera peut-être aussi nécessaire de modifier la configuration du compilateur pour - s'assurer que les fichiers d'en-têtes d'Apache seront correctement + s'assurer que les fichiers d'en-têtes d'Apache httpd seront correctement localisés. Vous trouverez cette bibliothèque à la racine du répertoire des modules de votre serveur. Il est souhaitable d'utiliser un fichier de module .dsp existant dans l'arborescence Modified: httpd/httpd/trunk/docs/manual/mod/mod_status.xml.fr URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_status.xml.fr?rev=928468&r1=928467&r2=928468&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/mod/mod_status.xml.fr (original) +++ httpd/httpd/trunk/docs/manual/mod/mod_status.xml.fr Sun Mar 28 18:29:30 2010 @@ -62,7 +62,7 @@ du serveur requête (*)

Le pourcentage CPU instantané utilisé par chaque processus et - par Apache tout entier (*)

+ par l'ensemble des processus (*)

Les hôtes et requêtes actuellement en cours de traitement (*)

@@ -114,8 +114,8 @@ du serveur permet d'obtenir une version du fichier d'état lisible par une machine. Ceci s'avère intéressant dans le cadre d'une exécution automatique : voir le programme en Perl - log_server_statussitué dans le répertoire - /support de la distribution d'Apache.

+ log_server_status situé dans le répertoire + /support de votre distribution du serveur HTTP Apache.

Veuillez noter que si mod_status a été Modified: httpd/httpd/trunk/docs/manual/sections.xml.fr URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/sections.xml.fr?rev=928468&r1=928467&r2=928468&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/sections.xml.fr (original) +++ httpd/httpd/trunk/docs/manual/sections.xml.fr Sun Mar 28 18:29:30 2010 @@ -3,7 +3,7 @@ - +