Application Web
================
* Une application web est une application client/serveur
* Où le client est généralement un navigateur (browser)‏
* Où le serveur est généralement un serveur web (Apache, par ex.)‏
* Fonctionnant en mode déconnecté
* Grâce au protocole HTTP
* Avec des données présentées en (X)HTML

Le formulaire HTML
------------------

* Au sein d'une page XHTML ou HTML, utilisant le protocole HTTP
* Les balises <form> et </form> encadrent le formulaire :
* L'attribut « method » est « GET » (transmission par URL) ou « POST » (tranmission par l'en-tête HTTP)‏
* L'attribut « action » indique la page vers laquelle les données sont envoyées

* Les champs d'entrée :
    - <input> de type « text », « checkbox », « radio », « hidden », « password », « image », « file » ou « submit »
    - <textarea>
    - <select> et <option>
* Les boutons « send » et « reset »

.. literalinclude:: file/form_elt.html
    :language: html

La récupération des données
----------------------------

* Le script PHP de récupération des données doit se trouver dans l'attribut « action » du formulaire
* Toutes les données sont envoyées dans des tableaux PHP prédéfinis, acccessibles de partout (« superglobales »).
* L'index des variables superglobales est le nom du champ du formulaire

**Les « superglobales » :**

* $_GET[] : données envoyées par l'URL (méthode GET)‏
* $_POST[] : données envoyées par un formulaire en POST
* $_COOKIE[] : données de cookies
* $_REQUEST[] : fusion de $_GET, $_POST et $_COOKIE
* $_FILES[] : fichiers envoyés par formulaire

**L'index des variables superglobales est le nom du champ du formulaire**

Récupérer les données d'un champ <input> :
-------------------------------------------

* $_POST['nomChamp'] ou
* $_GET['nomChamp'] ou
* $_REQUEST['nomChamp']
* $_REQUEST fonctionne toujours !
	=> Si plusieurs champs HTML sont envoyés par plusieurs méthodes avec le même nom, la priorité est : 1. cookies, 2. post, 3. get.

.. literalinclude:: file/form_elt.php
    :language: php

.. literalinclude:: file/form_recuperation.php
    :language: php

Les cases à cocher
------------------
.. code-block:: html

    <input type="checkbox"> : la valeur (par défaut à « on ») n'est transmise que si la case est cochée.

* =>	utilisation de la fonction

.. code-block:: php

    isset($_REQUEST['nomCaseaCocher']


.. literalinclude:: file/form_checkbox.html
    :language: html


.. literalinclude:: file/form_checkbox.php
    :language: php

**Exercice :**
Remplacer le code précédent par une boucle.


Les sélections multiples
-------------------------

.. code-block:: html

    <select name="nomSelect" multiple> : le même paramètre peut être envoyé plusieurs fois avec différentes valeurs. => risque de ne garder que le dernier !!!

=>	combiner 2 solutions :

* mettre [] à la fin du champ HTML

.. code-block:: html

    <select name="nomSelect[]" multiple>

* récupérer en PHP un tableau contenant les valeurs sélectionnées

.. code-block:: php

    foreach ($_REQUEST["nomSelect"] as value)‏


.. literalinclude:: file/form_selectMultiple.html
    :language: html



.. literalinclude:: file/form_selectMultiple.php
    :language: php

Les lignes multiples
____________________

.. code-block:: html

    <textarea name="nomTextarea"> : plusieurs lignes sont envoyées, avec des retours à la ligne. Mais les retours à la ligne ne sont pas des caractères HTML => le contenu du textarea ne peut pas être affiché sur une page HTML


=>	utilisation de la fonction

.. code-block:: php

    nl2br($_REQUEST['nomTextarea']

pour transformer les “new line” (nl) en “br”, et pouvoir afficher le contenu du textarea sur une page HTML

.. literalinclude:: file/form_textarea.html
    :language: html

.. literalinclude:: file/form_textarea.php
    :language: php

Les images cliquables
----------------------

.. code-block:: html

    <input type="image" name="nomImg" src=... > : la position du clic de souris est envoyée.

L'abscisse du point de clic est donnée par le nom du champ suivi de _x (dans ce cas “nomImg_x”); l'ordonnée est donnée par le nom du champ suivi de _y (dans ce cas “nomImg_y”).

Les fichiers
------------

.. code-block:: html

    <input type="file" name="nomFile"> : les données sont récupérées dans la superglobale $_FILES[].

.. code-block:: php

    $FILES[] est un tableau à 2 dimensions :

* 1ère dimension : nom du champ du formulaire
* 2ème dimension : nom de l'information sur le fichier transmis : 'name' pour le nom original, 'type' pour le type MIME du fichier, 'size' pour la tailel du fichier, 'tmp_name' pour le nom du fichier temporaire sur le serveur, 'error' pour l'erreur associée au téléchargement

Par exemple :

.. code-block:: php

    $_FILES['nomFile']['nom'];

.. literalinclude:: file/form_file.html
    :language: html

.. literalinclude:: file/form_file.php
    :language: php

**Exercice**

.. configuration-block::

    .. code-block:: php-annotations

      //Créez un formulaire qui permette d’ajouter une personne (nom, prenom).
      //Récupérez les données de ce formulaire, et afficher les en gras et majuscule.

    .. code-block:: html

        <!doctype html>
        <html lang="fr">
        <head>
            <meta charset="UTF-8">
            <title>Document</title>
        </head>
        <body>
        <form action="request.php" method="post">

            <input type="text" name="nom" id="nom">
            <input type="text" name="prenom" id="prenom">
            <input type="submit" value="Envoyer">

        </form>
        </body>
        </html>

    .. code-block:: html+php

        <?php

        $nom    = $_POST['nom'];
        $prenom = $_POST['prenom'];
        ?>

        <!doctype html>
        <html lang="fr">
        <head>
            <meta charset="UTF-8">
            <title>Document</title>
        </head>
        <body>
        Nom : <?php echo strtoupper($nom); ?>
        Pr&eacute;nom : <?php echo strtoupper($prenom) ?>
        </body>
        </html>


La création dynamique de formulaire
------------------------------------

* PHP peut permettre de créer des formulaires de manière dynamique :
    * En produisant les données qui seront les « valeurs » du formulaire
        - Valeur par défaut d'un champ
        - Liste de données d'une sélection
            =>	Question de l'insertion de ces champs dans le 	formulaire HTML ???
    * En produisant les champs mêmes du formulaire, avec le nom de chaque champ

* Problème: le champ d'un formulaire doit avoir une valeur par défaut calculée (par ex, la date du jour).
* Solution : un script PHP s'occupe d'afficher tout le formulaire, avec la bonne valeur dans le champ par défaut.
* Difficulté: faire imprimer du HTML par PHP, ce qui n'est pas très maintenable
* Défi: la séparation des couches en PHP

* Pour séparer les couches, plusieurs voies possibles:
    - syntaxe heredoc,
    - division du script en une partie HTML et une partie PHP,
    - séparation des couches view/controller grâce à des includes,
    (gestion approfondie de « templates »)‏
* Exemple: afficher un champ texte avec la date du jour comme valeur par défaut

**Heredoc**

.. literalinclude:: file/form_dynamique_donnee_heredoc.php
    :language: php

**HTML + PHP**

.. literalinclude:: file/form_dynamique_donnee_divisionscript.php
    :language: html+php

**HTML séparé de PHP**

**La vue**


.. literalinclude:: file/form_dynamique_donnee_include_view.php
    :language: html+php

**Le PHP**

.. literalinclude:: file/form_dynamique_donnee_include_controller.php
 :language: php

**Récupération**

.. literalinclude:: file/form_dynamique_donnee_traitement.php
    :language: php

La création de champs
---------------------

* Problème: il faut créer un formulaire qui s'adapte automatiquement au nombre de données.
* Difficulté: donner des noms de champs dynamiquement
* Plusieurs voies de solution :
    - Donner un nom différent à chaque champ grâce à un index numérique, et on indique le nombre de champs dans un champ hidden
    - Donner à toutes les champs le même nom, mais suivi de « [ ] ». PHP renvoie alors un tableau de valeurs

* Par exemple :
    * Imaginons une application de gestion de composition familiale :
    * tout dabord (écran 1), on demande combien d'enfants compte la famille,
    * Ensuite, pour chaque enfant (écran 2), on demande de spécifier un âge
    * Enfin, (écran 3) on établit un récapitulatif

.. configuration-block::

    .. code-block:: php-annotations

      # A vous

    .. code-block:: html

        <html >
         <head>
          <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />

          <title>Formulaire traité par PHP</title>
         </head>
        <body>
             <form action="composition_familiale.php" method="post" >
            <legend><b>Vos données personnelles</b></legend>
                <label>Nom : </label>
                <input type="text" name="nom" size="40" value="" /><br />
                <label>Prénom : </label>
                <input type="text" name="prenom" size="40" value="" /><br />
               <legend><b>Combien d'enfants compte votre famille ?</b></legend>
                <label>Nombre d'enfants : </label>
                <input type="text" name="nombre" size="40" value="" /><br />
                <input type="submit" value="Envoyer" />
              </form>
         </body>
        </html>

    .. code-block:: html+php


        <?php

            $nombreenfant = $_POST['nombre'];

        ?>


        <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr">
         <head>
          <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />

          <title>Formulaire traité par PHP</title>
         </head>
        <body>
             <form action="composition_familiale_ecran2_controller.php" method="get" enctype="multipart/form-data">

               <legend><b>Indiquez l'âge pour chacun d'entre eux</b></legend>
               <?php for ($i=0; $i<$nombreenfant;$i++): ?>

                <label>Age de l'enfant <?php echo $i+1 ?> : </label>
                <input type="text" name="age[]" size="40" value="" /><br />
                <?php endfor; ?>

                <input type="submit" value="Envoyer" />
              </form>
         </body>
        </html>

    .. code-block:: html+php

        <?php
        $age = $_POST['age'];
        ?>
        <html>
         <head>
          <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />

          <title>Formulaire traité par PHP</title>
         </head>
        <body>
             <h1>Récapitulatif</h1>

               <?php for($i=0;$i<count($age);$i++) : ?>
                <p>Age de l'enfant <?php echo $i+1 ?> : <?php echo $age[$i] ?> </p>
                <?php endfor; ?>

         </body>
        </html>