From: Lucien Gentis Date: Mon, 29 Jun 2026 15:40:38 +0000 (+0000) Subject: fr doc XML file update. X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=6979e6d8a3d0ad50b860de8a127b1eb13fe2be58;p=thirdparty%2Fapache%2Fhttpd.git fr doc XML file update. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1935711 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/howto/cgi.xml.fr b/docs/manual/howto/cgi.xml.fr index 15a81e4b7a..c643ea1865 100644 --- a/docs/manual/howto/cgi.xml.fr +++ b/docs/manual/howto/cgi.xml.fr @@ -1,7 +1,7 @@ - + @@ -57,28 +57,42 @@
Configurer httpd pour autoriser CGI -

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 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é - commentée dans votre httpd.conf. Une directive correcte - doit ressembler à ceci : - - - LoadModule cgid_module modules/mod_cgid.so - - - - Sous Windows, ou si l'on utilise un module MPM non-threadé comme prefork, - une directive correctement configurée sera du style : - - - LoadModule cgi_module modules/mod_cgi.so - +

La configuration de httpd doit autoriser l’exécution de CGI pour que les + programmes CGI fonctionnent. Il existe plusieurs manières d’y parvenir, qui + sont décrites ci-après.

+ +

La prise en charge de CGI est assurée par deux modules : + mod_cgid et mod_cgi. + mod_cgid utilise un démon externe dédié pour gérer les + processus CGI et est requis lorsque httpd utilise un MPM threadé (tel que + event ou worker). mod_cgi + exécute les programmes CGI directement depuis le processus du serveur et est + utilisé avec les MPMs non threadés tels que prefork, ou + sous Windows. Du point de vue de la configuration, ils sont interchangeables + — les directives sont les mêmes. Voir les pages de référence de + mod_cgi et mod_cgid pour les détails de + l’implémentation.

+ + Si httpd a été compilé avec le support des modules + partagés (DSO), vous devez vous assurer que le module approprié est chargé ; + vous devez pour cela vérifier que la directive LoadModule correspondante n'a pas été commentée + dans votre httpd.conf. Pour un MPM threadé : + + + +LoadModule cgid_module modules/mod_cgid.so + + + + Pour Windows, ou un MPM non threadé comme prefork : + + + +LoadModule cgi_module modules/mod_cgi.so + + +
@@ -95,9 +109,11 @@ module="mod_alias">ScriptAlias se présente comme suit :

- + + ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/" - + +

Cet exemple est tiré de votre fichier de configuration httpd.conf par défaut, si vous avez installé httpd @@ -120,12 +136,11 @@ tant que programme CGI.

Par exemple, si une requête pour l'URL - http://www.example.com/cgi-bin/test.pl est - 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 httpd - renverra un message d'erreur.

+ http://www.example.com/cgi-bin/test.py est effectuée, httpd + tentera d'exécuter le fichier + /usr/local/apache2/cgi-bin/test.py et en renverra la sortie. + Le fichier doit exister, être exécutable, et produire une sortie sous le + format attendu, sinon httpd renverra un message d'erreur.

@@ -168,23 +183,27 @@ l'exécution des programmes CGI est permise depuis un répertoire particulier :

- + + <Directory "/usr/local/apache2/htdocs/somedir"> - Options +ExecCGI +Options +ExecCGI </Directory> - + +

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 serveur qu'il doit traiter tous les fichiers possédant une - extension cgi ou pl en tant que + extension cgi ou py en tant que programmes CGI :

- - AddHandler cgi-script .cgi .pl - + + +AddHandler cgi-script .cgi .py + +
@@ -204,23 +223,27 @@ répertoire utilisateur, vous pouvez utiliser la configuration suivante :

- + + <Directory "/home/*/public_html"> - Options +ExecCGI - AddHandler cgi-script .cgi +Options +ExecCGI +AddHandler cgi-script .cgi </Directory> - + +

Pour indiquer un sous-répertoire cgi-bin d'un répertoire utilisateur où tout fichier sera traité en tant que programme CGI, vous pouvez utiliser ceci :

- + + <Directory "/home/*/public_html/cgi-bin"> - Options ExecCGI - SetHandler cgi-script +Options ExecCGI +SetHandler cgi-script </Directory> - + +
@@ -229,8 +252,8 @@
Ecrire un programme CGI -

Il y a deux différences principales entre la programmation - "standard" et la programmation CGI.

+

La programmation CGI diffère de la programmation + "standard" sur deux points.

En premier lieu, toute sortie de votre programme CGI doit être précédée d'un en-tête MIME-type. Il s'agit d'un @@ -244,7 +267,7 @@

En second lieu, votre sortie doit être en HTML, ou tout autre format qu'un navigateur est en mesure d'afficher. La plupart du temps, il s'agira de HTML, mais occasionnellement, vous pouvez être - amené à écrire un programme CGI qui renvoie une image gif, ou un + amené à écrire un programme CGI qui renvoie une image GIF, ou un autre type de contenu non-HTML.

A part ces deux différences, un programme CGI ressemblera à tout @@ -256,33 +279,29 @@

L'exemple suivant est un exemple de programme CGI qui permet d'afficher une ligne de caractères dans votre navigateur. Ecrivez ce qui suit, enregistrez le dans un fichier nommé - premier.pl, et placez le dans votre répertoire + premier.py, et placez le dans votre répertoire cgi-bin.

- -#!/usr/bin/perl -print "Content-type: text/html\n\n"; -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 à 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 - déclaration du type de contenu considéré, suivie de deux paires - "Retour chariot - Nouvelle ligne". Ceci a pour effet d'insérer une - ligne vide après l'en-tête pour marquer la fin des en-têtes HTTP, - et le début du corps du document. La troisième ligne affiche la - chaîne de caractères "Bonjour tout le monde . . .". Et c'est tout - ce dont vous avez besoin.

+ + +#!/usr/bin/env python3 +print("Content-type: text/html\n") +print("Hello, World.") + + + +

La première ligne indique au système d’exploitation quel interpréteur + utiliser. La première invocation de print affiche l’en-tête content-type + suivi d’une ligne vide (le \n dans la chaîne et la nouvelle + ligne qu’ajoute print()), qui matérialise la fin des en-têtes + HTTP. La seconde invocation de print affiche le corps. C’est là tout ce + dont un programme CGI a besoin pour produire une réponse.

Si vous ouvrez votre navigateur favori et lui indiquez l'adresse

- http://www.example.com/cgi-bin/premier.pl + http://www.example.com/cgi-bin/premier.py

ou toute autre URL correspondant à votre programme CGI, Vous @@ -297,9 +316,8 @@ print "Hello, World.";

Mais ça ne marche toujours pas ! -

Vous devriez voir au moins une des quatre sorties suivantes dans - votre navigateur lorsque vous essayez d'accéder à votre programme - CGI depuis le web :

+

Quatre sorties basiques pourront apparaître dans votre navigateur lorsque + vous essayez d'accéder à votre programme CGI depuis le web :

Le flux de sortie de votre programme CGI
@@ -345,9 +363,11 @@ print "Hello, World."; nobody, il suffit de lui attribuer des droits d'exécution pour tout le monde :

- - chmod a+x premier.pl - + + +chmod a+x first.py + +

En outre, si votre programme doit pouvoir accéder en lecture et/ou écriture à d'autres fichiers, ces derniers devront avoir les @@ -374,13 +394,15 @@ print "Hello, World."; CGI.

Un exemple typique de spécification de programme est le chemin - vers l'interpréteur de script (souvent perl) que l'on + vers l'interpréteur de script (souvent python3) que l'on trouve à la première ligne de votre programme CGI et qui va ressembler à ceci :

- - #!/usr/bin/perl - + + +#!/usr/bin/env python3 + +

Assurez-vous qu'il s'agit bien du chemin correct vers l'interpréteur.

@@ -425,10 +447,10 @@ print "Hello, World."; cd /usr/local/apache2/cgi-bin
- ./premier.pl + ./premier.py -

(N'invoquez pas l'interpréteur perl. Le shell et +

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

@@ -476,7 +498,7 @@ print "Hello, World.";

Si vous ne maîtrisez pas le fonctionnement de suexec, il vous est déconseillé de l'utiliser. Pour désactiver suexec, supprimer - simplement (ou renommez) l'exécutable suexec + (ou renommez) l'exécutable suexec pointé par SUEXEC_BIN et redémarrez le serveur. Si après une lecture de suexec, vous décidez quand-même de l'utiliser, tapez la commande suexec @@ -521,7 +543,7 @@ print "Hello, World."; variables requises se trouve dans la 3875 (Common Gateway Interface).

-

Ce programme CGI basique en Perl permet d'afficher toutes les +

Ce programme CGI basique en Python permet d'afficher toutes les variables d'environnement qui sont échangées. Deux programmes similaires sont fournis avec la distribution de httpd et situés dans le répertoire cgi-bin. @@ -533,16 +555,16 @@ print "Hello, World."; variables d'environnement aux variables de base fournies par défaut.

- -#!/usr/bin/perl -use strict; -use warnings; + + +#!/usr/bin/env python3 +import os -print "Content-type: text/html\n\n"; -foreach my $key (keys %ENV) { - print "$key --> $ENV{$key}<br>"; -} - +print("Content-type: text/html\n") +for key, value in os.environ.items(): +print(f"{key} --> {value}<br>") + +
@@ -600,17 +622,13 @@ foreach my $key (keys %ENV) { partie du travail de base pour vous. Ceci vous permettra de diminuer le nombre d'erreurs et d'accélérer le développement.

-

Si vous écrivez des programmes CGI en Perl, des modules sont à - votre disposition à CPAN. A ce - sujet, le module le plus populaire est CGI.pm. Vous - pouvez aussi essayer CGI::Lite, qui implémente les - fonctionnalités strictement nécessaires, mais suffisantes pour - la majorité des programmes.

- -

Si vous écrivez des programmes CGI en C, vous disposez de nombreuses - options. L'une d'elles est la bibliothèque CGIC de https://web.mit.edu/wwwdev/www/cgic.html.

+

Si vous écrivez des programmes CGI en Python, le module cgi + de la bibliothèque standard (obsolète dans Python 3.11, supprimé dans Python + 3.13) prenait en charge l’analyse de formulaire. Avec les versions actuelles + de Python, utilisez le module urllib.parse pour analyser les + chaîne de paramètres et les données de formulaire. Pour des applications + plus complexes, orientez-vous vers un cadriciel WSGI léger, bien que cela + aille au-delà du domaine de la CGI traditionnelle.

@@ -628,10 +646,10 @@ foreach my $key (keys %ENV) { programme CGI a été écrit, et, si possible, son code source. Ceci permettra une résolution plus aisée de votre problème.

-

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

+ problème dans le code source de httpd.