From: Lucien Gentis Date: Fri, 24 Apr 2026 14:28:21 +0000 (+0000) Subject: fr doc XML files updates. X-Git-Url: http://git.ipfire.org/gitweb/?a=commitdiff_plain;h=ebf72d9861bf5b035a024305958b121c62942077;p=thirdparty%2Fapache%2Fhttpd.git fr doc XML files updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1933291 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/howto/cgi.xml.fr b/docs/manual/howto/cgi.xml.fr index 47aa9681d5..27f0a8efd1 100644 --- a/docs/manual/howto/cgi.xml.fr +++ b/docs/manual/howto/cgi.xml.fr @@ -1,7 +1,7 @@ - + @@ -25,7 +25,7 @@ Recettes et tutoriels - Tutoriel Apache : Contenu dynamique basé sur CGI + Didacticiel du serveur HTTP Apache : Contenu dynamique basé sur CGI
Introduction @@ -50,18 +50,18 @@ s'agit d'une méthode simple pour ajouter du contenu dynamique à votre site web en utilisant votre langage de programmation préféré. Ce document est une introduction à la configuration de CGI sur votre - serveur web Apache, et une initiation à l'écriture de programmes + serveur web HTTP Apache, et une initiation à l'écriture de programmes CGI.

- Configurer Apache pour autoriser CGI + Configurer httpd pour autoriser CGI -

Apache doit être configuré pour permettre l'exécution des +

httpd doit être configuré pour permettre l'exécution des programmes CGI, pour que vos programmes CGI puissent fonctionner correctement. Il existe plusieurs méthodes pour y parvenir.

- Note: si Apache a été compilé avec le support + Note: si httpd a été compilé avec le support des modules partagés (DSO), vous devez vous assurer que le module CGI est chargé ; vous devez pour cela vérifier que la directive LoadModule correspondante n'a pas été @@ -85,8 +85,8 @@ ScriptAlias

La directive ScriptAlias indique à Apache qu'un - répertoire particulier est dédié aux programmes CGI. Apache + module="mod_alias">ScriptAlias indique à httpd qu'un + répertoire particulier est dédié aux programmes CGI. httpd considérera que tout fichier situé dans ce répertoire est un programme CGI, et tentera de l'exécuter lorsque cette ressource fera l'objet d'une requête client.

@@ -100,7 +100,7 @@

Cet exemple est tiré de votre fichier de configuration - httpd.conf par défaut, si vous avez installé Apache + httpd.conf par défaut, si vous avez installé httpd dans son répertoire par défaut. La directive ScriptAlias est similaire à la directive Alias, qui @@ -114,17 +114,17 @@ réside dans le fait que ScriptAlias indique en plus que tout ce qui se trouve sous le préfixe d'URL doit être considéré comme un programme CGI. Ainsi, l'exemple ci-dessus - indique à Apache que toute requête pour une ressource commençant + indique à httpd que toute requête pour une ressource commençant par /cgi-bin/ doit être servie depuis le répertoire /usr/local/apache2/cgi-bin/, et doit être traitée en tant que programme CGI.

Par exemple, si une requête pour l'URL http://www.example.com/cgi-bin/test.pl est - effectuée, Apache tentera d'exécuter le fichier + effectuée, httpd tentera d'exécuter le fichier /usr/local/apache2/cgi-bin/test.pl et en renverra la sortie. Bien entendu, le fichier doit exister, être exécutable, et - retourner sa sortie d'une manière particulière, sinon Apache + retourner sa sortie d'une manière particulière, sinon httpd renverra un message d'erreur.

@@ -174,7 +174,7 @@ </Directory> -

La directive ci-dessus indique à Apache qu'il doit permettre +

La directive ci-dessus indique à httpd qu'il doit permettre l'exécution des fichiers CGI. Vous devez aussi indiquer au serveur quels fichiers sont des fichiers CGI. La directive AddHandler suivante indique au @@ -267,7 +267,7 @@ print "Hello, World.";

Même si Perl ne vous est pas familier, vous devriez être capable de comprendre le fonctionnement de ce programme. La - première ligne indique à Apache (ou à toute interface à partir de + première ligne indique à httpd (ou à toute interface à partir de laquelle le programme s'exécute) que ce programme peut être exécuté en fournissant son fichier à l'interpréteur /usr/bin/perl. La seconde ligne affiche la @@ -311,20 +311,20 @@ print "Hello, World.";

Le code source de votre programme CGI ou un message "POST Method Not Allowed"
-
Cela signifie que vous n'avez pas configuré Apache de manière +
Cela signifie que vous n'avez pas configuré httpd de manière à ce qu'il puisse traiter votre programme CGI. Relisez la section - sur la configuration d'Apache, et + sur la configuration de httpd, et essayez de trouver votre erreur.
Un message commençant par "Forbidden"
Ce type de message est révélateur d'un problème de droits. Consultez le journal des erreurs - d'Apache et la section ci-dessous sur les et la section ci-dessous sur les droits des fichiers.
Un message contenant "Internal Server Error"
Si vous consultez le journal des erreurs - d'Apache, vous y trouverez probablement des messages du type + de httpd, vous y trouverez probablement des messages du type "Premature end of script headers" (Fin prématurée des en-têtes de script), éventuellement accompagnés d'un message d'erreur généré par votre programme CGI. Dans ce cas, il va vous falloir lire @@ -402,7 +402,7 @@ print "Hello, World.";

Si votre programme CGI dépend de variables d'environnement non standards, vous devrez vous assurez que - ces variables lui sont bien transmises par Apache.

+ ces variables lui sont bien transmises par httpd.

Lorsque des en-têtes HTTP ne sont pas transmis à l'environnement, assurez-vous qu'ils sont bien formatés selon la @@ -430,14 +430,14 @@ print "Hello, World.";

(N'invoquez pas l'interpréteur perl. Le shell et - Apache doivent être capable de le déterminer à partir de l'information sur le chemin située sur la première ligne du script.)

La première chose que vous devriez voir affichée par votre programme est un ensemble d'en-têtes HTTP, comprenant entre autres le Content-Type, et suivi d'une ligne vide. Si vous - voyez quoi que ce soit d'autre, Apache renverra l'erreur + voyez quoi que ce soit d'autre, httpd renverra l'erreur Premature end of script headers si vous tentez d'exécuter le programme depuis le serveur. Voir Ecriture d'un programme CGI ci-dessus pour @@ -471,7 +471,7 @@ print "Hello, World.";

Pour savoir si vous pouvez utiliser suexec, tapez la commande apachectl -V, et regardez le chemin indiqué par - SUEXEC_BIN. Si au démarrage d'Apache, ce dernier + SUEXEC_BIN. Si au démarrage d'httpd, ce dernier trouve un exécutable suexec dans ce chemin, suexec sera activé.

@@ -514,7 +514,7 @@ print "Hello, World."; définissent aussi des variables d'environnement, de façon à ce qu'ils puissent communiquer entre eux. Ces variables définissent entre autre le type de navigateur (Netscape, IE, Lynx), le type de - serveur (Apache, IIS, WebSite), le nom du programme CGI en cours + serveur (httpd, IIS, WebSite), le nom du programme CGI en cours d'exécution, etc...

Ces variables sont à la disposition du programmeur CGI, et @@ -525,12 +525,12 @@ print "Hello, World.";

Ce programme CGI basique en Perl permet d'afficher toutes les variables d'environnement qui sont échangées. Deux programmes - similaires sont fournis avec la distribution d'Apache et situés + similaires sont fournis avec la distribution de httpd et situés dans le répertoire cgi-bin. Notez que certaines variables sont obligatoires, alors que d'autres sont optionnelles, si bien que vous verrez s'afficher certaines variables qui ne font pas partie - de la liste officielle. De plus, Apache vous propose de nombreuses + de la liste officielle. De plus, httpd vous propose de nombreuses méthodes pour ajouter vos propres variables d'environnement aux variables de base fournies par défaut.

@@ -633,8 +633,8 @@ foreach my $key (keys %ENV) {

Notez que les questions à propos de problèmes CGI ne doivent jamais être postées dans la base de données de - bogues d'Apache, à moins que vous ne soyez sûr d'avoir trouvé un - problème dans le code source d'Apache.

+ bogues de httpd, à moins que vous ne soyez sûr d'avoir trouvé un + problème dans le code source de httpd.

diff --git a/docs/manual/mod/mod_unique_id.xml.fr b/docs/manual/mod/mod_unique_id.xml.fr index d3b14aa650..a9f4cf9aa6 100644 --- a/docs/manual/mod/mod_unique_id.xml.fr +++ b/docs/manual/mod/mod_unique_id.xml.fr @@ -1,7 +1,7 @@ - + @@ -179,7 +179,7 @@ identifiant unique pour chaque requête par codage du quadruplet de 144 bits (adresse IP sur 32 bits, pid sur 32 bits, repère de temps sur 32 bits, compteur 16 bits et index de threads sur 32 bits) en - utilisant l'alphabet [A-Za-z0-9@-] d'une manière + utilisant l'alphabet [A-Za-z0-9_-] d'une manière similaire à celle du codage MIME base64, et sa valeur se présente sous la forme d'une chaîne de 24 caractères. L'alphabet MIME base64 est en fait [A-Za-z0-9+/] ; cependant, les caractères diff --git a/docs/manual/programs/ctlogconfig.xml.fr b/docs/manual/programs/ctlogconfig.xml.fr index a2a8279537..4e0d353232 100644 --- a/docs/manual/programs/ctlogconfig.xml.fr +++ b/docs/manual/programs/ctlogconfig.xml.fr @@ -1,7 +1,7 @@ - + @@ -185,22 +185,24 @@ transparence des certificats certificats sont enregistrés :

- $ ctlogconfig /path/to/conf/log-config configure-url http://log1.example.com/
- $ ctlogconfig /path/to/conf/log-config configure-url http://log2.example.com/
- $ ctlogconfig /path/to/conf/log-config dump
- Log entry:
- Record 1
- Log id : (not configured)
- Public key file: (not configured)
- URL : http://log1.example.com/
- Time range : -INF to +INF
-
- Log entry:
- Record 2
- Log id : (not configured)
- Public key file: (not configured)
- URL : http://log2.example.com/
- Time range : -INF to +INF
+ +$ ctlogconfig /path/to/conf/log-config configure-url http://log1.example.com/ +$ ctlogconfig /path/to/conf/log-config configure-url http://log2.example.com/ +$ ctlogconfig /path/to/conf/log-config dump +Log entry: + Record 1 + Log id : (not configured) + Public key file: (not configured) + URL : http://log1.example.com/ + Time range : -INF to +INF + +Log entry: + Record 2 + Log id : (not configured) + Public key file: (not configured) + URL : http://log2.example.com/ + Time range : -INF to +INF +

Nous pouvons maintenant attribuer une clé publique à un log où le @@ -209,21 +211,23 @@ transparence des certificats a déjà été configuré.

- $ ctlogconfig /path/to/conf/log-config configure-public-key \#2 /path/to/conf/log2-pub.pem
- $ ctlogconfig /path/to/conf/log-config dump
- Log entry:
- Record 1
- Log id : (not configured)
- Public key file: (not configured)
- URL : http://log1.example.com/
- Time range : -INF to +INF
-
- Log entry:
- Record 2
- Log id : (not configured)
- Public key file: /path/to/conf/log2-pub.pem
- URL : http://log2.example.com/
- Time range : -INF to +INF
+ +$ ctlogconfig /path/to/conf/log-config configure-public-key \#2 /path/to/conf/log2-pub.pem +$ ctlogconfig /path/to/conf/log-config dump +Log entry: + Record 1 + Log id : (not configured) + Public key file: (not configured) + URL : http://log1.example.com/ + Time range : -INF to +INF + +Log entry: + Record 2 + Log id : (not configured) + Public key file: /path/to/conf/log2-pub.pem + URL : http://log2.example.com/ + Time range : -INF to +INF + diff --git a/docs/manual/programs/dbmmanage.xml.fr b/docs/manual/programs/dbmmanage.xml.fr index 3acc40d942..472bd87455 100644 --- a/docs/manual/programs/dbmmanage.xml.fr +++ b/docs/manual/programs/dbmmanage.xml.fr @@ -1,7 +1,7 @@ - + @@ -29,13 +29,13 @@ utilisateurs au format DBM -

dbmmanage permet de créer et de maintenir les +

dbmmanage permet de créer et de maintenir les fichiers au format DBM où sont stockés les noms d'utilisateurs et mots de passe à des fins d'authentification de base des utilisateurs HTTP via le module mod_authn_dbm. Il est possible de restreindre l'accès aux ressources disponibles sur le serveur HTTP Apache aux seuls utilisateurs spécifiés dans les fichiers créés - par dbmmanage. Ce programme ne peut être utilisé + par dbmmanage. Ce programme ne peut être utilisé qu'avec des fichiers d'utilisateurs au format DBM. Pour l'utilisation de fichiers textes, voir le programme htpasswd.

@@ -186,20 +186,20 @@ utilisateurs au format DBM GDBM, et Berkeley DB 2. Malheureusement, toutes ces bibliothèques utilisent des formats de fichiers différents, et vous devez vous assurer que le format de fichier utilisé par nom-fichier - correspond au format attendu par dbmmanage. - Actuellement, dbmmanage n'a aucun moyen de savoir à + correspond au format attendu par dbmmanage. + Actuellement, dbmmanage n'a aucun moyen de savoir à quel type de fichier DBM il a à faire. S'il est utilisé avec un format inapproprié, il ne renverra rien, ou pourra créer un fichier DBM différent avec un nom différent, ou au pire, va corrompre le fichier DBM si vous avez tenté de le modifier.

-

dbmmanage possède une liste de préférences en +

dbmmanage possède une liste de préférences en matière de formats DBM, définies dans le tableau @AnyDBM::ISA au début du programme. Comme nous préférons le format de fichier Berkeley DB 2, l'ordre dans lequel - dbmmanage va rechercher les bibliothèques système est + dbmmanage va rechercher les bibliothèques système est Berkeley DB 2, puis NDBM, GDBM et enfin SDBM. La première - bibliothèque trouvée sera celle que dbmmanage tentera + bibliothèque trouvée sera celle que dbmmanage tentera d'utiliser pour toutes les opérations sur les fichiers DBM. Cette ordre est sensiblement différent de l'ordre standard de Perl @AnyDBM::ISA, et de l'ordre utilisé par l'appel diff --git a/docs/manual/programs/htpasswd.xml.fr b/docs/manual/programs/htpasswd.xml.fr index e7c3c8b036..41cc132489 100644 --- a/docs/manual/programs/htpasswd.xml.fr +++ b/docs/manual/programs/htpasswd.xml.fr @@ -1,7 +1,7 @@ - + @@ -29,28 +29,28 @@ l'authentification de base

-

htpasswd permet de créer et de maintenir les +

htpasswd permet de créer et de maintenir les fichiers textes où sont stockés les noms d'utilisateurs et mots de passe pour l'authentification de base des utilisateurs HTTP. Si - htpasswd rencontre un problème d'accès à un fichier, + htpasswd rencontre un problème d'accès à un fichier, que ce soit pour écrire dans le fichier de sortie, ou pour lire le fichier d'entrée dans le but de le mettre à jour, il renvoie un code d'erreur et n'effectue aucune modification.

Il est possible de limiter l'accès aux ressources du serveur HTTP Apache aux seuls utilisateurs présents dans les fichiers créés par - htpasswd. Ce programme ne sait gérer les noms + htpasswd. Ce programme ne sait gérer les noms d'utilisateurs et mots de passe que s'ils sont stockés dans des fichiers textes. Il peut cependant hasher et afficher les mots de passe à des fins d'utilisation dans d'autres types de bases de données. Pour utiliser une base de données DBM, voir le programme dbmmanage ou htdbm.

-

htpasswd hashe les mots de passe en utilisant soit bcrypt, +

htpasswd hashe les mots de passe en utilisant soit bcrypt, une version de MD5 modifiée pour Apache, soit SHA1, soit la routine crypt() du système. Les hashes basés sur SHA-2 (SHA-256 et SHA-512) sont supportés pour crypt(). Les fichiers gérés par - htpasswd peuvent contenir deux types de mots de passe ; + htpasswd peuvent contenir deux types de mots de passe ; certaines entrées peuvent contenir des mots de passe hashés en MD5 ou bcrypt, alors que d'autres entrées du même fichier contiendront des mots de passe hashés avec crypt().

@@ -201,7 +201,7 @@ support/SHA1.
-p
Enregistre les mots de passe en clair. Bien que - htpasswd supporte la création des mots de passe en + htpasswd supporte la création des mots de passe en clair sur toutes les plates-formes, le démon httpd n'accepte les mots de passe en clair que sous Windows et Netware.
@@ -234,9 +234,9 @@ support/SHA1.
Valeur renvoyée -

htpasswd renvoie 0 ("true") si le nom d'utilisateur +

htpasswd renvoie 0 ("true") si le nom d'utilisateur et le mot de passe ont été enregistrés ou mis à jour avec succès - dans le fichier-mots-de-passe. htpasswd + dans le fichier-mots-de-passe. htpasswd renvoie 1 s'il a rencontré un problème d'accès aux fichiers, 2 si la ligne de commande comportait une erreur de syntaxe, 3 si le mot de passe entré @@ -259,7 +259,7 @@ support/SHA1. jsmith. Le mot de passe est demandé à l'opérateur. Le mot de passe sera hashé en utilisant l'algorithme MD5 modifié pour Apache. Si le fichier spécifié - n'existe pas, htpasswd renverra un code d'erreur.

+ n'existe pas, htpasswd renverra un code d'erreur.

htpasswd -c /home/doe/public_html/.htpasswd jane @@ -268,7 +268,7 @@ support/SHA1.

Crée un nouveau fichier de mots de passe et y enregistre une entrée pour l'utilisateur jane. Le mot de passe est demandé à l'opérateur. Si le fichier existe et ne peut être ni lu ni - écrit, il n'est pas modifié et htpasswd affichera un + écrit, il n'est pas modifié et htpasswd affichera un message et renverra un code d'erreur.

@@ -282,7 +282,7 @@ support/SHA1.
Considérations à propos de sécurité

Les fichiers de mots de passe Web comme ceux que gère - htpasswd ne doivent pas être situés dans + htpasswd ne doivent pas être situés dans l'espace d'URI du serveur Web -- en d'autres termes, il ne doit pas être possible d'y accéder à partir d'un navigateur.

@@ -318,11 +318,11 @@ support/SHA1.
Restrictions

Sur les plates-formes Windows, la taille des mots de passe - hashés avec htpasswd est limitée à 255 + hashés avec htpasswd est limitée à 255 caractères. Les mots de passe dont la taille est supérieure seront tronqués.

-

L'algorithme MD5 utilisé par htpasswd est spécifique +

L'algorithme MD5 utilisé par htpasswd est spécifique à Apache ; les mots de passe hashés en utilisant cet algorithme seront inutilisables sur d'autres serveurs Web.

diff --git a/docs/manual/programs/rotatelogs.xml.fr b/docs/manual/programs/rotatelogs.xml.fr index 6c775e2561..98e320ed3e 100644 --- a/docs/manual/programs/rotatelogs.xml.fr +++ b/docs/manual/programs/rotatelogs.xml.fr @@ -1,7 +1,7 @@ - + @@ -29,7 +29,7 @@ ces derniers dans un "pipe" -

rotatelogs est un programme simple à utiliser en +

rotatelogs est un programme simple à utiliser en conjonction avec la fonctionnalité d'Apache de redirection dans un "pipe" des fichiers journaux. Il supporte une rotation basée sur un intervalle de temps ou une taille maximale du journal.

@@ -68,20 +68,20 @@ spécifié. Cette option permet de consulter le journal de manière continue malgré les rotations via une commande du style tail -F nom-lien.

Si le nom du lien spécifié n'est pas un chemin absolu, il est relatif au -répertoire de travail de rotatelogs qui correspond à la valeur de +répertoire de travail de rotatelogs qui correspond à la valeur de la directive ServerRoot lorsque la commande -rotatelogs est exécutée par le serveur. +rotatelogs est exécutée par le serveur.

-p programme
-

Avec cette option, rotatelogs exécutera le programme +

Avec cette option, rotatelogs exécutera le programme programme chaque fois qu'un nouveau fichier journal sera ouvert. Le nom du fichier nouvellement ouvert est passé comme premier argument au programme. Si l'exécution se produit après une rotation, l'ancien nom du fichier journal est passé au programme comme second argument.

-

rotatelogs +

rotatelogs n'attend pas la fin du programme pour continuer son exécution, et cessera tout enregistrement de codes d'erreur lorsqu'il aura terminé son processus.

@@ -96,7 +96,7 @@ du fichier journal ne sont pas modifiées par cette rotation.

-f
Ouvre le fichier journal immédiatement, dès que -rotatelogs démarre, au lieu d'attendre la lecture de la +rotatelogs démarre, au lieu d'attendre la lecture de la première entrée de journal (pour les sites peu chargés, il peut s'écouler un temps substantiel entre le démarrage du serveur et le traitement de la première requête, temps pendant lequel le fichier @@ -176,9 +176,9 @@ mégaoctets, et si la limite de 5 mégaoctets a été atteinte deux fois dans la même journée, le même nom de fichier va être généré, et la rotation va écraser le fichier existant.

Si le nom du fichier journal n'est pas un chemin absolu, il est relatif au -répertoire de travail de rotatelogs qui correspond à la valeur de +répertoire de travail de rotatelogs qui correspond à la valeur de la directive ServerRoot lorsque la commande -rotatelogs est exécutée par le serveur. +rotatelogs est exécutée par le serveur.