<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/tutorial.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'tutorial.forms.php',
    1 => 'Utiliser un formulaire',
    2 => 'Utiliser un formulaire',
  ),
  'up' => 
  array (
    0 => 'tutorial.php',
    1 => 'Une introduction &agrave; PHP',
  ),
  'prev' => 
  array (
    0 => 'tutorial.useful.php',
    1 => 'Trucs pratiques',
  ),
  'next' => 
  array (
    0 => 'tutorial.whatsnext.php',
    1 => 'Et apr&egrave;s ?',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'chapters/tutorial.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="tutorial.forms" class="section">
   <div class="info"><h1 class="title">Utiliser un formulaire</h1></div>
   <p class="para">
    L&#039;un des points forts de PHP est sa capacité à gérer les formulaires.
    Le concept de base qui est important à comprendre est que tous les
    champs d&#039;un formulaire seront automatiquement disponibles dans le
    script PHP d&#039;action. Consulter le chapitre du manuel concernant les
    <a href="language.variables.external.php" class="link">variables depuis des sources externes à PHP</a>
    pour plus d&#039;informations et d&#039;exemples sur la façon d&#039;utiliser les
    formulaires. Voici un exemple de formulaire HTML :
   </p>
   <p class="para">
    <div class="example" id="example-1">
     <div class="info"><p><strong>Exemple #1 Un simple formulaire HTML</strong></p></div>
     <div class="example-contents">
<div class="htmlcode"><pre class="htmlcode">&lt;form action=&quot;action.php&quot; method=&quot;post&quot;&gt;
   &lt;label for=&quot;nom&quot;&gt;Votre nom :&lt;/label&gt;
   &lt;input name=&quot;nom&quot; id=&quot;nom&quot; type=&quot;text&quot;&gt;

   &lt;label for=&quot;age&quot;&gt;Votre âge :&lt;/label&gt;
   &lt;input name=&quot;age&quot; id=&quot;age&quot; type=&quot;number&quot;&gt;

   &lt;button type=&quot;submit&quot;&gt;Valider&lt;/button&gt;
&lt;/form&gt;</pre>
</div>
     </div>

    </div>
   </p>
   <p class="para">
    Il n&#039;y a rien de particulier dans ce formulaire. Il est en HTML
    pur, sans aucune configuration particulière. Lorsque le visiteur
    remplit le formulaire et clique sur le bouton Valider, le
    fichier <var class="filename">action.php</var> est appelé. Dans ce
    fichier, il est possible d&#039;écrire le script suivant :
   </p>
   <p class="para">
    <div class="example" id="example-2">
     <div class="info"><p><strong>Exemple #2 Afficher des données issues d&#039;un formulaire</strong></p></div>
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">Bonjour, <span style="color: #0000BB">&lt;?php </span><span style="color: #007700">echo </span><span style="color: #0000BB">htmlspecialchars</span><span style="color: #007700">(</span><span style="color: #0000BB">$_POST</span><span style="color: #007700">[</span><span style="color: #DD0000">'nom'</span><span style="color: #007700">]); </span><span style="color: #0000BB">?&gt;</span>.<br />Tu as <span style="color: #0000BB">&lt;?php </span><span style="color: #007700">echo (int) </span><span style="color: #0000BB">$_POST</span><span style="color: #007700">[</span><span style="color: #DD0000">'age'</span><span style="color: #007700">]; </span><span style="color: #0000BB">?&gt;</span> ans.</span></code></div>
     </div>

     <div class="example-contents"><p>
      Voici le résultat possible, selon
      les valeurs saisies :
     </p></div>
     <div class="example-contents screen">
<div class="cdata"><pre>
Bonjour Jean.
Tu as 29 ans.
</pre></div>
     </div>
    </div>
   </p>
   <p class="para">
    Mis à part les parties <span class="function"><a href="function.htmlspecialchars.php" class="function">htmlspecialchars()</a></span> et
    <code class="literal">(int)</code>, ce script ne fait que des choses évidentes.
    <span class="function"><a href="function.htmlspecialchars.php" class="function">htmlspecialchars()</a></span> s&#039;assure que tous les caractères
    spéciaux HTML sont proprement encodés afin d&#039;éviter des injections
    de balises HTML et de Javascript dans les pages. Pour l&#039;âge, vu que
    c&#039;est un entier, il est possible de le
    <a href="language.types.type-juggling.php#language.types.typecasting" class="link">convertir</a> en un
    <a href="language.types.integer.php" class="link">entier</a>. PHP peut également le faire
    automatiquement en utilisant l&#039;extension
    <a href="ref.filter.php" class="link">filter</a>.
    Les variables <var class="varname"><a href="reserved.variables.post.php" class="classname">$_POST['nom']</a></var> et
    <var class="varname"><a href="reserved.variables.post.php" class="classname">$_POST['age']</a></var> sont automatiquement créées par PHP.
    Un peu plus tôt dans ce tutoriel, nous avons utilisé la variable
    <var class="varname"><a href="reserved.variables.server.php" class="classname">$_SERVER</a></var>, une superglobale. Maintenant, nous avons
    introduit une autre superglobale <var class="varname"><a href="reserved.variables.post.php" class="classname">$_POST</a></var>
    qui contient toutes les données envoyées par la méthode POST. Il est à noter que
    dans notre formulaire, nous avons choisi la <em>méthode</em> POST.
    Si nous avions utilisé la méthode <em>GET</em> alors notre formulaire
    aurait placé ces informations dans la variable <var class="varname"><a href="reserved.variables.get.php" class="classname">$_GET</a></var>,
    une autre superglobale. Il est également possible d&#039;utiliser la variable
    <var class="varname"><a href="reserved.variables.request.php" class="classname">$_REQUEST</a></var>,
    pour ne pas se soucier de la méthode utilisée. Elle contient
    un mélange des données de GET, POST et COOKIE.
   </p>
  </div><?php manual_footer($setup); ?>