diff options
| author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 15:01:30 +0000 |
|---|---|---|
| committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 15:01:30 +0000 |
| commit | 6beeb1b708550be0d4a53b272283e17e5e35fe17 (patch) | |
| tree | 1ce8673d4aaa948e5554000101f46536a1e4cc29 /docs/manual/howto/cgi.html.fr.utf8 | |
| parent | Initial commit. (diff) | |
| download | apache2-3d46059c28a1d66e6e1aeb209491f1324c913a25.tar.xz apache2-3d46059c28a1d66e6e1aeb209491f1324c913a25.zip | |
Adding upstream version 2.4.57.upstream/2.4.57
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'docs/manual/howto/cgi.html.fr.utf8')
| -rw-r--r-- | docs/manual/howto/cgi.html.fr.utf8 | 643 |
1 files changed, 643 insertions, 0 deletions
diff --git a/docs/manual/howto/cgi.html.fr.utf8 b/docs/manual/howto/cgi.html.fr.utf8 new file mode 100644 index 0000000..8ce0d77 --- /dev/null +++ b/docs/manual/howto/cgi.html.fr.utf8 @@ -0,0 +1,643 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!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> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Tutoriel Apache : Contenu dynamique basé sur CGI - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur HTTP Apache Version 2.4</p> +<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">Recettes et tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Tutoriel Apache : Contenu dynamique basé sur CGI</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../es/howto/cgi.html" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/howto/cgi.html" title="Français"> fr </a> | +<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> +</div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">Introduction</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#configuring">Configurer Apache pour autoriser CGI</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#writing">Ecrire un programme CGI</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">Mais ça ne marche toujours pas !</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#behindscenes">Que se passe-t-il en coulisse</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#libraries">Bibliothèques et modules CGI</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#moreinfo">Pour plus d'informations</a></li> +</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="intro" id="intro">Introduction</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_alias.html">mod_alias</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li></ul></td></tr></table> + + <p>CGI (Common Gateway Interface) définit une méthode d'interaction + entre un serveur web et des programmes générateurs de contenu + externes, plus souvent appelés programmes CGI ou scripts CGI. + Il 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 + CGI.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="configuring" id="configuring">Configurer Apache pour autoriser CGI</a></h2> + + + <p>Apache 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.</p> + + <div class="warning">Note: si Apache 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 <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> correspondante n'a pas été + commentée dans votre <code>httpd.conf</code>. Une directive correcte + doit ressembler à ceci : + + <pre class="prettyprint lang-config">LoadModule cgid_module modules/mod_cgid.so</pre> + + + + Sous Windows, ou si l'on utilise un module MPM non-threadé comme prefork, + une directive correctement configurée sera du style : + + <pre class="prettyprint lang-config">LoadModule cgi_module modules/mod_cgi.so</pre> +</div> + + + <h3><a name="scriptalias" id="scriptalias">ScriptAlias</a></h3> + + + <p>La directive <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> indique à Apache qu'un + répertoire particulier est dédié aux programmes CGI. Apache + 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.</p> + + <p>La directive <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> se présente comme suit + :</p> + + <pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"</pre> + + + <p>Cet exemple est tiré de votre fichier de configuration + <code>httpd.conf</code> par défaut, si vous avez installé Apache + dans son répertoire par défaut. La directive <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> est similaire à la + directive <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, qui + définit à quel répertoire particulier doit correspondre un préfixe + d'URL. <code class="directive">Alias</code> et + <code class="directive">ScriptAlias</code> sont généralement utilisés pour + accéder à des répertoires situés en dehors du répertoire défini + par la directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. La différence entre + <code class="directive">Alias</code> et <code class="directive">ScriptAlias</code> + réside dans le fait que <code class="directive">ScriptAlias</code> 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 + par <code>/cgi-bin/</code> doit être servie depuis le répertoire + <code>/usr/local/apache2/cgi-bin/</code>, et doit être traitée en + tant que programme CGI.</p> + + <p>Par exemple, si une requête pour l'URL + <code>http://www.example.com/cgi-bin/test.pl</code> est + effectuée, Apache tentera d'exécuter le fichier + <code>/usr/local/apache2/cgi-bin/test.pl</code> 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 + renverra un message d'erreur.</p> + + + <h3><a name="nonscriptalias" id="nonscriptalias">CGI en dehors des répertoires ScripAlias</a></h3> + + + <p>Pour des raisons de sécurité, la localisation des programmes + CGI est souvent restreinte aux + répertoires définis par <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>. De cette manière, les administrateurs + peuvent contrôler précisément qui est autorisé à utiliser les + programmes CGI. Cependant, si les précautions adéquates quant à + la sécurité sont prises, il n'y a aucune raison pour que les + programmes CGI ne puissent pas être exécutés depuis d'autres + répertoires. Par exemple, vous pouvez autoriser les utilisateurs à + enregistrer des contenus web dans leurs répertoires home à l'aide + de la directive <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>. S'ils veulent mettre en + oeuvre leurs propres programmes CGI, mais n'ont pas l'autorisation + d'accès au répertoire <code>cgi-bin</code> principal, ils devront + être en mesure d'exécuter ces programmes depuis un autre + répertoire.</p> + + <p>L'autorisation d'exécution des programmes CGI dans un + répertoire arbitraire se fait en deux étapes. En premier lieu, le + gestionnaire <code>cgi-script</code> doit être activé à l'aide + d'une directive <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> ou <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>. En second lieu, + <code>ExecCGI</code> doit être spécifié dans la directive <code class="directive"><a href="../mod/core.html#options">Options</a></code>.</p> + + + <h3><a name="options" id="options">Utilisation d'options explicites pour permettre l'exécution + des programmes CGI</a></h3> + + + <p>Vous pouvez utiliser de manière explicite la directive + <code class="directive"><a href="../mod/core.html#options">Options</a></code> dans le fichier de + configuration de votre serveur principal, pour indiquer que + l'exécution des programmes CGI est permise depuis un répertoire + particulier :</p> + + <pre class="prettyprint lang-config"><Directory "/usr/local/apache2/htdocs/somedir"> + Options +ExecCGI +</Directory></pre> + + + <p>La directive ci-dessus indique à Apache qu'il doit permettre + l'exécution des fichiers CGI. Vous devez aussi indiquer au serveur + quels fichiers sont des fichiers CGI. La directive <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> suivante indique au + serveur qu'il doit traiter tous les fichiers possédant une + extension <code>cgi</code> ou <code>pl</code> en tant que + programmes CGI :</p> + + <pre class="prettyprint lang-config">AddHandler cgi-script .cgi .pl</pre> + + + + <h3><a name="htaccess" id="htaccess">Fichiers .htaccess</a></h3> + + + <p>Le <a href="htaccess.html"><code>tutoriel + .htaccess</code></a> montre comment activer les programmes + CGI si vous n'avez pas accès au + fichier <code>httpd.conf</code>.</p> + + + <h3><a name="userdir" id="userdir">Répertoires utilisateurs</a></h3> + + + <p>Pour permettre l'exécution en tant que programme CGI de tout + fichier possédant l'extension <code>.cgi</code> et situé dans un + répertoire utilisateur, vous pouvez utiliser la configuration + suivante :</p> + + <pre class="prettyprint lang-config"><Directory "/home/*/public_html"> + Options +ExecCGI + AddHandler cgi-script .cgi +</Directory></pre> + + + <p>Pour indiquer un sous-répertoire <code>cgi-bin</code> d'un + répertoire utilisateur où tout fichier sera traité en tant que + programme CGI, vous pouvez utiliser ceci :</p> + + <pre class="prettyprint lang-config"><Directory "/home/*/public_html/cgi-bin"> + Options ExecCGI + SetHandler cgi-script +</Directory></pre> + + + + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="writing" id="writing">Ecrire un programme CGI</a></h2> + + + <p>Il y a deux différences principales entre la programmation + "standard" et la programmation CGI.</p> + + <p>En premier lieu, toute sortie de votre programme CGI doit être + précédée d'un en-tête <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">MIME-type</a>. Il s'agit d'un + en-tête HTTP qui indique au client quel type de contenu il reçoit. + La plupart du temps, il se présente comme suit :</p> + + <div class="example"><p><code> + Content-type: text/html + </code></p></div> + + <p>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 + autre type de contenu non-HTML.</p> + + <p>A part ces deux différences, un programme CGI ressemblera à tout + autre programme que vous pourriez être amené à écrire.</p> + + <h3><a name="firstcgi" id="firstcgi">Votre premier programme CGI</a></h3> + + + <p>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é + <code>premier.pl</code>, et placez le dans votre répertoire + <code>cgi-bin</code>.</p> + + <pre class="prettyprint lang-perl">#!/usr/bin/perl +print "Content-type: text/html\n\n"; +print "Hello, World.";</pre> + + + <p>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 + laquelle le programme s'exécute) que ce programme peut être + exécuté en fournissant son fichier à l'interpréteur + <code>/usr/bin/perl</code>. 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.</p> + + <p>Si vous ouvrez votre navigateur favori et lui indiquez + l'adresse</p> + + <div class="example"><p><code> + http://www.example.com/cgi-bin/premier.pl + </code></p></div> + + <p>ou toute autre URL correspondant à votre programme CGI, Vous + verrez la ligne <code>Bonjour tout le monde . . .</code> + s'afficher dans la fenêtre de votre navigateur. Ce n'est pas + extraordinaire, mais si vous y êtes parvenu, vous avez de bonnes + chances d'y parvenir pour tout autre programme plus + sophistiqué.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="troubleshoot" id="troubleshoot">Mais ça ne marche toujours pas !</a></h2> + + + <p>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 :</p> + + <dl> + <dt>Le flux de sortie de votre programme CGI</dt> + <dd>Impeccable ! Cela signifie que tout fonctionne correctement. + Si la sortie est correcte mais n'est pas traitée correctement par + le navigateur, assurez-vous d'avoir défini + <code>Content-Type</code> de manière appropriée dans votre + programme CGI.</dd> + + <dt>Le code source de votre programme CGI ou un message "POST + Method Not Allowed"</dt> + <dd>Cela signifie que vous n'avez pas configuré Apache de manière + à ce qu'il puisse traiter votre programme CGI. Relisez la section + sur la <a href="#configuring">configuration d'Apache</a>, et + essayez de trouver votre erreur.</dd> + + <dt>Un message commençant par "Forbidden"</dt> + <dd>Ce type de message est révélateur d'un problème de + droits. Consultez le <a href="#errorlogs">journal des erreurs + d'Apache</a> et la section ci-dessous sur les <a href="#permissions">droits des fichiers</a>.</dd> + + <dt>Un message contenant "Internal Server Error"</dt> + <dd>Si vous consultez le <a href="#errorlogs">journal des erreurs + d'Apache</a>, 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 + chacune des sections ci-dessous pour déterminer ce qui empêche + votre programme CGI de générer les en-têtes appropriés.</dd> + </dl> + + <h3><a name="permissions" id="permissions">Droits des fichiers</a></h3> + + + <p>Souvenez-vous que le serveur ne s'exécute pas sous votre nom. + En d'autres termes, lorsque le serveur a démarré, il s'exécute + avec les droits d'un utilisateur non privilégié - en général + <code>nobody</code>, ou <code>www</code> - et en conséquence, il + aura besoin de droits supplémentaires pour pouvoir exécuter des + fichiers dont vous êtes le propriétaire. En général, pour qu'un + fichier ait des droits suffisants pour être exécutable par + <code>nobody</code>, il suffit de lui attribuer des droits + d'exécution pour tout le monde :</p> + + <div class="example"><p><code> + chmod a+x premier.pl + </code></p></div> + + <p>En outre, si votre programme doit pouvoir accéder en lecture + et/ou écriture à d'autres fichiers, ces derniers devront avoir les + droits appropriés.</p> + + + + <h3><a name="pathinformation" id="pathinformation">Chemin des exécutables (PATH) et variables + d'environnement</a></h3> + + + <p>Lorsque vous lancez un programme depuis la ligne de commande, + certaines informations sont passées au shell sans que vous vous en + doutiez. Par exemple, la variable <code>PATH</code> indique au + shell où il doit rechercher les exécutables auxquels vous faites + référence.</p> + + <p>Lorsqu'un programme s'exécute depuis le serveur web en tant que + programme CGI, sa variable <code>PATH</code> n'aura peut-être pas + la même valeur. Tout programme que vous invoquez dans votre + programme CGI ( comme par exemple <code>sendmail</code>) devra + être spécifié par son chemin complet, de façon à ce que le shell + puisse le trouver lorsqu'il tentera d'exécuter votre programme + CGI.</p> + + <p>Un exemple typique de spécification de programme est le chemin + vers l'interpréteur de script (souvent <code>perl</code>) que l'on + trouve à la première ligne de votre programme CGI et qui va + ressembler à ceci :</p> + + <pre class="prettyprint lang-perl">#!/usr/bin/perl</pre> + + + <p>Assurez-vous qu'il s'agit bien du chemin correct vers + l'interpréteur.</p> + + <div class="warning"> + Lors de l'édition de scripts CGI sous Windows, il se peut que des + caractères de fin de ligne soient ajoutés au chemin de + l'interpréteur. Assurez-vous donc que les fichiers sont bien + transmis au serveur en mode ASCII. Dans le cas contraire, l'OS + pourra envoyer des avertissements "Command not found" à cause des + caractères de fin de ligne non reconnus car considérés comme + faisant partie du nom de fichier de l'interpréteur. + </div> + + + + <h3><a name="missingenv" id="missingenv">Variables d'environnement manquantes</a></h3> + + + <p>Si votre programme CGI dépend de <a href="#env">variables + d'environnement</a> non standards, vous devrez vous assurez que + ces variables lui sont bien transmises par Apache.</p> + + <p>Lorsque des en-têtes HTTP ne sont pas transmis à + l'environnement, assurez-vous qu'ils sont bien formatés selon la + <a href="http://tools.ietf.org/html/rfc2616">RFC 2616</a>, section + 4.2 : les noms d'en-têtes doivent commencer par une lettre, + elle-même suivie de lettres, chiffres ou traits d'union. Tout + en-tête dont le nom viole cette règle sera ignoré.</p> + + + + <h3><a name="syntaxerrors" id="syntaxerrors">Erreurs inhérentes au programme</a></h3> + + + <p>La plupart des échecs dans l'exécution d'un programme CGI + proviennent du programme lui-même. Ceci est particulièrement vrai + lorsque ce satané programme CGI se bloque, alors que vous avez + appris à ne plus commettre les deux erreurs précédentes. La + première chose à faire est de vous assurer que votre programme + s'exécute depuis la ligne de commande, avant de le tester à partir + du serveur web. Par exemple, essayez :</p> + + <div class="example"><p><code> + cd /usr/local/apache2/cgi-bin<br /> + ./premier.pl + </code></p></div> + + <p>(N'invoquez pas l'interpréteur <code>perl</code>. Le shell et + Apache doivent être capable de le déterminer à partir de <a href="#pathinformation">l'information sur le chemin</a> située sur + la première ligne du script.)</p> + + <p>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 <code>Content-Type</code>, et suivi d'une ligne vide. Si vous + voyez quoi que ce soit d'autre, Apache renverra l'erreur + <code>Premature end of script headers</code> si vous tentez + d'exécuter le programme depuis le serveur. Voir <a href="#writing">Ecriture d'un programme CGI</a> ci-dessus pour + plus de détails.</p> + + + <h3><a name="errorlogs" id="errorlogs">Journalisation des erreurs</a></h3> + + + <p>Les journaux d'erreurs sont vos amis. Toute anomalie de + fonctionnement est consignée dans le journal des erreurs et c'est + ici que vous devez regarder en premier en cas de problème. Si + l'hébergeur de votre site ne vous donne pas accès au journal des + erreurs, vous avez tout intérêt à vous tourner vers quelqu'un + d'autre. Apprenez à déchiffrer les journaux d'erreurs, et vous + vous apercevrez que la plupart des problèmes seront rapidement + identifiés . . . et résolus.</p> + + + <h3><a name="suexec" id="suexec">Suexec</a></h3> + + + <p>Le programme <a href="../suexec.html">suexec</a> permet + d'exécuter les programmes CGI avec des droits différents selon le + serveur virtuel ou le répertoire utilisateur dans lequel ils + se situent. Suexec effectue une vérification des droits très + stricte, et toute anomalie détectée au cours de cette vérification + entraînera un echec d'exécution de votre programme CGI avec + affichage de l'erreur <code>Premature end of script + headers</code>.</p> + + <p>Pour savoir si vous pouvez utiliser suexec, tapez la commande + <code>apachectl -V</code>, et regardez le chemin indiqué par + <code>SUEXEC_BIN</code>. Si au démarrage d'Apache, ce dernier + trouve un exécutable <code class="program"><a href="../programs/suexec.html">suexec</a></code> dans ce chemin, + suexec sera activé.</p> + + <p>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 <code class="program"><a href="../programs/suexec.html">suexec</a></code> + pointé par <code>SUEXEC_BIN</code> et redémarrez le serveur. Si + après une lecture de <a href="../suexec.html">suexec</a>, vous + décidez quand-même de l'utiliser, tapez la commande <code>suexec + -V</code> pour voir où se situe le journal de suexec, et utilisez + ce dernier pour déterminer quelles règles vous violez + éventuellement.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="behindscenes" id="behindscenes">Que se passe-t-il en coulisse</a></h2> + + + <p>Lorsque vos compétences en programmation CGI seront plus + poussées, il s'avérera intéressant pour vous de mieux comprendre ce + qui se passe en coulisse, et en particulier la manière dont le + navigateur et le serveur dialoguent entre eux. En effet, bien qu'il + soit tout à fait louable d'écrire un programme qui affiche "Bonjour + tout le monde . . .", cela ne sert pas à grand chose.</p> + + <h3><a name="env" id="env">Variables d'environnement</a></h3> + + + <p>Les variables d'environnement sont des valeurs qui gravitent + autour de vous lorsque vous utilisez votre ordinateur. Elles sont + très utiles, à l'instar de votre chemin par défaut (où votre + ordinateur va rechercher le fichier physique correspondant à la + commande que vous avez tapée), votre nom d'utilisateur, le type de + votre terminal, etc... Pour obtenir une liste complète des + variables d'environnement standards que vous utilisez tous les + jours, tapez <code>env</code> dans votre interpréteur + de commandes.</p> + + <p>Au cours de la transaction CGI, le serveur et le navigateur + 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 + d'exécution, etc...</p> + + <p>Ces variables sont à la disposition du programmeur CGI, et + elles constituent 50% de la communication client-serveur. La liste + complète des variables requises se trouve à + <a href="http://www.ietf.org/rfc/rfc3875">Common Gateway + Interface RFC</a>.</p> + + <p>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 + dans le répertoire <code>cgi-bin</code>. + 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 + méthodes pour <a href="../env.html">ajouter vos propres + variables d'environnement</a> aux variables de base fournies par + défaut.</p> + + <pre class="prettyprint lang-perl">#!/usr/bin/perl +use strict; +use warnings; + +print "Content-type: text/html\n\n"; +foreach my $key (keys %ENV) { + print "$key --> $ENV{$key}<br>"; +}</pre> + + + + <h3><a name="stdin" id="stdin">STDIN et STDOUT</a></h3> + + + <p>L'entrée standard (<code>STDIN</code>) et la sortie standard + (<code>STDOUT</code>) constituent d'autres voies de communication + entre le client et le serveur. Dans un contexte normal, + <code>STDIN</code> correspond au clavier, ou à un fichier fourni + au programme à des fins de traitement, et <code>STDOUT</code> à la + console ou à l'écran.</p> + + <p>Lorsque vous transmettez un formulaire web à un programme CGI + par la méthode <code>POST</code>, les données de ce formulaire + sont transcrites dans un format spécial et transmises à votre + programme CGI via <code>STDIN</code>. Le programme peut alors les + traiter comme si elles provenaient du clavier ou d'un + fichier.</p> + + <p>Ce "format spécial" est très simple. Un nom de champ et sa + valeur sont reliés entre eux par un signe "égal" (=), et chacune + de ces paires nom champ/valeur est séparée de la suivante par un + "et" commercial (&). Les caractères + spéciaux comme les espaces, les "et" commerciaux, et les signes + "égal" sont convertis en leur équivalent hexadécimal pour éviter + qu'ils ne gâchent le travail. La chaîne contenant les données doit + ressembler à ceci :</p> + + <div class="example"><p><code> + name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey + </code></p></div> + + <p>Vous verrez aussi parfois une chaîne de ce type accolée à une + URL. Dans ce cas, le serveur enregistre cette chaîne dans la + variable d'environnement appelée <code>QUERY_STRING</code>. On a + alors affaire à une requête de type <code>GET</code>. Votre + formulaire HTML indique laquelle des méthodes <code>GET</code> ou + <code>POST</code> est utilisée pour transmettre les données, en + définissant l'attribut <code>METHOD</code> au niveau de la balise + <code>FORM</code>.</p> + + <p>Votre programme est ensuite chargé d'extraire les informations + utiles de cette chaîne. Heureusement, des bibliothèques et des + modules sont à votre disposition pour vous aider à traiter ces + données, et à gérer les différents aspects de votre programme + CGI.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="libraries" id="libraries">Bibliothèques et modules CGI</a></h2> + + + <p>Pour écrire un programme CGI, il vous est conseillé d'utiliser + une bibliothèque de code, ou un module, qui effectueront une grande + partie du travail de base pour vous. Ceci vous permettra de diminuer + le nombre d'erreurs et d'accélérer le développement.</p> + + <p>Si vous écrivez des programmes CGI en Perl, des modules sont à + votre disposition à <a href="http://www.cpan.org/">CPAN</a>. A ce + sujet, le module le plus populaire est <code>CGI.pm</code>. Vous + pouvez aussi essayer <code>CGI::Lite</code>, qui implémente les + fonctionnalités strictement nécessaires, mais suffisantes pour + la majorité des programmes.</p> + + <p>Si vous écrivez des programmes CGI en C, vous disposez de nombreuses + options. L'une d'elles est la bibliothèque <code>CGIC</code> de <a href="https://web.mit.edu/wwwdev/www/cgic.html">https://web.mit.edu/wwwdev/www/cgic.html</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="moreinfo" id="moreinfo">Pour plus d'informations</a></h2> + + + <p>La spécification CGI actuelle est disponible dans la <a href="http://www.ietf.org/rfc/rfc3875">Common Gateway + Interface RFC</a>.</p> + + <p>Lorsque vous postez une question à propos d'un problème CGI que + vous rencontrez, que ce soit dans une liste de diffusion ou dans un + newsgroup, faites en sorte de fournir suffisamment d'informations + sur le problème rencontré, ce que vous attendiez exactement, et en + quoi ce qui se produit est réellement différent de ce que vous + attendiez, quel serveur vous utilisez, en quel langage votre + programme CGI a été écrit, et, si possible, son code source. Ceci + permettra une résolution plus aisée de votre problème.</p> + + <p>Notez que les questions à propos de problèmes CGI ne doivent + <strong>jamais</strong> ê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.</p> + </div></div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../es/howto/cgi.html" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/howto/cgi.html" title="Français"> fr </a> | +<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/cgi.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Autorisé 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file |