.. _pratique__installer-serveur-local:

Installer un serveur local
##########################

Qu'est-ce qu'un serveur local ?
*******************************

Ici, il s'agit d'un logiciel qui va permettre de rendre certaines parties du système de fichier accessible dans le navigateur via le protocole http.

Pourquoi installer un serveur local ?
*************************************

Pour pouvoir consulter nos animations.

Celles-ci requièrent le chargement dynamique de fichiers .json et cela n'est pas permis (à raison) par les politiques de sécurité des navigateurs directement sur le système de fichier local.

Si nous mettons en place un serveur local, nous réglons le problème : il ne s'agira plus d'accéder au système de fichier dans son ensemble mais à une interface http spécifique.

Comment lancer un serveur local ?
*********************************

.. note::

   Si vous avez déjà un serveur local que vous connaissez, comme XAMPP, MAMPP ou WAMPP, vous pouvez vous en servir.

.. seealso::

   Cette documentation se base sur `Comment configurer un serveur de test local ? <https://developer.mozilla.org/fr/docs/Apprendre/Common_questions/configurer_un_serveur_de_test_local>`_

Avec Python
===========

ouvrir le terminal
------------------

Sur macOS : ouvrez l'application ``terminal``.
Sur ms-window : ouvrez l'application ``cmd.exe``.

vérifier la présence de python
------------------------------

Tapez la commande ``python -V``.

Vous obtiendrez soit un numéro de version (2.x.y ou 3.x.y), soit un message d'erreur.

.. raw:: html

   <iframe width="560" height="315" src="https://www.youtube.com/embed/X6v0Rv2KokE" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

installer python
----------------

Passez cette étape si vous avez obtenu un numéro de version à l'étape suivante.

* Allez sur `python.org <https://python.org>`_
* Sous Télécharger, cliquez le lien pour Python "3.xxx".
* Tout en bas de la page, pour MS-Windows, télécharger le fichier pointé par le lien Windows x86 executable installer.
* Exécuter ce programme quand le téléchargement est fini.
* Sur la première page de l'installeur, assurez-vous d'avoir coché la case  "Ajouter Python 3.xxx to PATH".
* Cliquer Install, puis Fermer quand l'installation est complète.
* vérifiez l'installation en réitérant l'étape précédente (la commande ``python -V``)


naviguer jusqu'au dossier à servir
----------------------------------

.. warning:

   Sous Windows, on utilisera ``dir`` (*directory*) et non ``ls`` (*List*).

1. taper dans le terminal ``cd`` (*Change Directory*) suivi d'une espace
2. glissez déposez votre dossier à servir dans le terminal

.. raw:: html

   <iframe width="560" height="315" src="https://www.youtube.com/embed/-8HxzU76B-I" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

lancer le serveur
-----------------

1. assurez-vous que vous êtes dans le bon dossier en affichant le contenu du dossier courant :

   * sur macOS, écrivez ``ls`` puis appuyez sur ``entrée``
   * sur ms-windows, écrivez ``dir`` puis appuyez sur ``entrée``

2. maintenant, lancez le serveur selon votre version de Python :

   * Python 2 : ``python -m SimpleHTTPServer``
   * Python 3 : ``python -m http.server`` ou ``python3 -m http.server``

.. warning:

   Dans certains cas, vous devrez utiliser ``py``au lieu de ``python``.

accéder au contenu servi
------------------------

Rendez-vous dans votre navigateur et tapez dans la barre d'URL ``localhost:8000`` et appuyez sur entrée.

Avec Node.js
============

Sur demande (avec http-server)