.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

=====================================
Cookie
=====================================

Les cookies sont des fichiers enregistrés sur l'ordinateur du client (le visiteur). Ils permettent de stocker des informations et de les lire. C'est un système qui permet d'identifier et de suivre les visiteurs. Par exemple, vous pouvez stocker dans un cookie le nom du visiteur de votre site demandé via un formulaire et ainsi, la prochain fois qu'il revient, vous pouvez lui souhaiter le bonjour avec son nom.


**Ecrire un cookie**
====================

Une fonction `setcookie()  <https://www.php.net/manual/fr/function.setcookie.php>`_) permet de créer un cookie. Il comprend en général les 3 premiers paramètres (son nom, sa valeur et sa date d'expiration). Cependant, d'autres paramètres sont disponibles.

Pour chaque valeur à stocker, un cookie est créé. Donc, si on désire stocker le nom et le navigateur utilisé de notre visiteur, deux cookies seront faits.

La fonction setcookie doit être placée avant d'appeler tout code html dans la page.

.. code-block:: php

   // Stocker le nom (qui vient d'un formulaire)
   $name = "Alfred";
   setcookie("name", $name, time() + 365*24*3600);

   // Stocker le navigateur utilisé 
   $browser = $_SERVER["HTTP_USER_AGENT"];
   setcookie("browser", $browser, time() + 365*24*3600);

   // Si vous souhaitez que votre cookie ne soit pas accessible via JavaScript,
   // vous devez activer l'option httpOnly
   setcookie("name", $name, time() + 365*24*3600, null, null, false, true);

**Afficher un cookie**
======================

Une super-globale existe pour utiliser le cookie : $_COOKIE["nom du cookie"];

.. code-block:: php

   $_COOKIE["name"]; // Alfred