Jérôme Cutrona

Version statique de l'intranet de Jérôme Cutrona - Rejoindre la version dynamique 🔒

Les exemples et corrections sont potentiellement non fonctionnels.

B.U.T. Informatique - IUT de Reims - Université de Reims

Installation d'un environnement de développement PHP sur Windows

Navigation
  1. Accueil
  2. Objectifs de la séance
  3. Introduction
  4. Installation / configuration de XAMPP
  5. Configuration de Windows pour utiliser PHP en ligne de commande
  6. Installation de PhpStorm
  7. Installation de Git
  8. Configuration de Git
  9. Configuration des extensions PHP
    1. Activation de l'extension intl
    2. Installation de l'extension Xdebug
  10. Configuration de MySQL / phpMyAdmin
    1. Création de compte utilisateur
    2. Création de base de données
    3. Protection de phpMyAdmin par authentification
  11. Configurer votre navigateur pour y intégrer un greffon de validation du code HTML
  12. Travailler pendant une séance de PHP en ligne de commande
  13. Travailler pendant une séance de PHP en mode serveur Web

Objectifs de la séance

  • Installer XAMPP
  • Configurer Windows pour pouvoir lancer PHP en ligne de commande
  • Installer Visual Studio Code
  • Installer Git
  • Configurer un utilisateur MySQL pour travailler

Introduction

Le travail à domicile vous oblige à configurer un environnement de développement PHP/Apache/MySQL/Git sur votre ordinateur personnel. Si vous n'avez pas accès à Linux à domicile et pour des raisons facilité et rapidité, ce guide vous permettra de développer en PHP sur Windows.

Pour ceux qui souhaitent travailler sur Linux, consultez le tutoriel « Installation et configuration d'une distribution Linux - Ubuntu ».

Installation / configuration de XAMPP

« XAMPP est l'environnement de développement PHP le plus populaire », telle est la phrase d'accroche du site https://www.apachefriends.org.

Avant de vous précipiter sur le téléchargement de la dernière version, précisons que XAMPP est un outil de développement, pas de mise en production de sites et que nous souhaitons que votre code fonctionne aussi bien chez vous qu'à l'IUT quand vous reviendrez en salle de TP. Vous installerez donc une version 8.3.* de PHP comme à l'IUT. Notez que l'ensemble du tutoriel a été écrit pour PHP 7.4. Vous devez l'adapter vous-même pour vous placer en PHP 8.3.

Remarque importante

Si vous aviez déjà installé une version de XAMPP, désinstallez-la. Attention, lors de la désinstallation, le répertoire htdocs et les bases de données MySQL seront supprimées. Il convient donc de copier le répertoire htdocs et d'exporter les bases de données à l'aide de phpMyAdmin avant désinstallation si vous souhaitez les préserver.

Travail à réaliser
  1. Rendez vous sur la page de téléchargement de XAMPP
  2. Téléchargez la version 7.4.*, 7.4.11 au moment de la rédaction de ce guide
    Remarque importante

    Notez que l'ensemble du tutoriel a été écrit pour PHP 7.4. Vous devez l'adapter vous-même pour vous placer en PHP 8.3.

  3. Lancez l'installation de XAMPP
    1. Acceptez l'alerte concernant votre antivirus qui peut ralentir ou perturber l'installation (tout devrait bien se dérouler) antivirus warning
    2. Acceptez l'alerte concernant le « User Account Control (UAC) » UAC warning
    3. Vous voici enfin au début de l'installation, passez à la suite Installation
    4. Il est à présent temps de choisir ce que vous souhaitez Installation
    5. Supprimez les composants inutiles et passez à la suite Installation
    6. Respectez bien le répertoire d'installation préconisé C:\xampp et passez à la suite Installation
    7. Décochez la case « Learn more about Bitnami for XAMPP » et passez à la suite Installation Installation
    8. XAMPP est prêt à s'installer, passez à la suite Installation
    9. Patientez quelques instants Installation
    10. Une alerte du pare-feu de Windows vous demande les autorisations pour le serveur Apache (serveur Web). Ne cochez que « Réseaux privés » Installation
    11. L'installation est terminée, appuyez sur « Finish » sans décocher « Do you want to start the Control Panel now » Installation
    12. Vous passez à présent à la configuration
  4. L'outil de configuration de XAMPP se lance automatiquement
    1. Choisissez votre langue et validez configuration
    2. Prenez note du message et validez configuration
    3. L'outil de configuration se présente comme suit configuration et peut être lancé par un double-clic sur l'icône correspondante dans la barre des tâches configuration
    4. Lancez Apache (le serveur Web) et MySQL (le serveur de bases de données) afin de vérifier s'ils fonctionnenent configuration
    5. Au lancement du serveur MySQL ne cochez que « Réseaux privés » dans la demande d'autorisations configuration
    6. Si vous développez en PHP Web / MySQL, activez le démarrage automatique des services Apache et MySQL en même temps que XAMPP en appuyant sur Le bouton « Config » configuration pour pouvoir cocher les cases correspondantes dans « Autostart of extensions » (ce n'est pas utile si vous faites uniquement du PHP en ligne de commande) configuration

Configuration de Windows pour utiliser PHP en ligne de commande

Windows, tout comme Linux, utilise une variable d'environnement qui stocke la liste des chemins dans lesquels les commandes sont cherchées. Vous allez modifier cette variable afin de pouvoir utiliser en ligne de commande dans l'invite de commande Windows.

Travail à réaliser
  1. Ouvrez votre menu démarrer, tapez « env » puis cliquez sur « Modifier les variables d'environnement pour votre compte » configuration Windows
  2. Dans cet outil, effectuez un double-clic sur la ligne de la variable Path configuration Windows
  3. Vous êtes à présent dans l'éditeur de variable d'environnement pour la variable Path configuration Windows que nous allons bientôt utiliser
  4. Localisez l'exécutable de PHP (php.exe) qui devrait se trouver dans C:\xampp\php configuration Windows
  5. Sélectionnez et copiez le chemin dans la barre d'adresse de votre explorateur de fichiers configuration Windows
  6. Revenez dans l'éditeur de la variable d'environnement Path et appuyez sur le bouton « Nouveau », collez le chemin précédemment copié et validez configuration Windows
  7. Ouvrez votre menu démarrer, tapez « cmd » puis cliquez sur « Invite de commandes » configuration Windows
  8. Dans l'« Invite de commandes », tapez php --version configuration Windows qui devrait vous répondre PHP 7.4.10 (cli)…

Installation de PhpStorm

Vous avez besoin d'un éditeur de code / IDE pour vos scripts PHP. Nous vous proposons PhpStorm.

Travail à réaliser
  1. Référez-vous au tutoriel dédié à l'installation et à la configuration de PhpStorm

Installation de Git

Le système de gestion de version distribué Git doit à présent être installé pour vous permettre de travailler en toute sérénité.

Travail à réaliser
  1. Accédez au téléchargement de Git sur https://git-scm.com/download/win, cliquez sur « Click here to download manually » et exécutez le programme d'installation téléchargé Git
  2. Prenez connaissance de la « GNU General Public Licence » et passez à la suite Git
  3. Vérifiez le chemin d'installation et passez à la suite Git
  4. Sélectionnez les options qui vous semblent utiles et passez à la suite Git
  5. Vérifiez le nom du dossier à créer dans le menu démarrer et passez à la suite Git
  6. Choisissez Visual Studio Code comme éditeur de par défaut pour Git (l'installation est décrire dans la partie précédente) et passez à la suite Git
  7. Choisissez l'installation « Git from the command line and also from 3rd-party software » et passez à la suite Git
  8. Choisissez l'option « Use OpenSSH » et passez à la suite Git
  9. Choisissez l'option « Use the OpenSSL library » et passez à la suite Git
  10. Choisissez l'option « Checkout Windows-style, commit Unix-style line endings » et passez à la suite Git
  11. Choisissez l'option « Use MinTTY (the default terminal of MSYS2) » et passez à la suite Git
  12. Vérifiez les options avant de procéder à l'installation effective Git
  13. Patientez quelques instants Git
  14. Terminez l'installation Git

Configuration de Git

Le système de gestion de version distribué Git doit à présent être configuré.

Travail à réaliser
  1. Ouvrez votre menu démarrer, tapez « git bash » puis cliquez sur « Git Bash » Git
  2. Vous utliserez Git Bash comme invite de commandes Git
  3. Vérifiez le bon fonctionnement de Git en pasant la commande git --version Git
  4. Précisez votre email en passant la commande git config --global user.email "votre_adresse_mail" Git
  5. Précisez votre nom en passant la commande git config --global user.name "votre_nom" Git
  6. Affichez les valeurs que vous venez de fixer avec la commande git config --global --list Git

Configuration des extensions PHP

Il est parfois nécessaire d'activer, désactiver voire installer des extensions PHP.

Activation de l'extension intl

Vous allez ici activer l'extension d'internationalisation intl.
Travail à réaliser
  1. Lancez le panneau de contrôle XAMPP extensions PHP
  2. Cliquez sur Le bouton « Config » de Apache pour atteindre « PHP (php.ini) » extensions PHP
  3. Ceci ouvre le fichier de configuration de PHP (php.ini) dans l'éditeur de texte par défaut extensions PHP
  4. Recherchez le texte « intl » extensions PHP
  5. Supprimez le point-virgule du début de la ligne pour qu'elle ne soit plus en commentaire extensions PHP
  6. Redémarrez le serveur Apache si vous utilisez PHP en mode Web

Installation de l'extension Xdebug

Xdebug est une extension PHP dédiée au débogage et au développement. Elle est notamment indispensable pour analyser la couverture de code avec PHPUnit.

Travail à réaliser
  1. Téléchargez la dernière version stable de l'extension (Xdebug 2.9.8) compatible avec votre installation (PHP 7.4 (64 bit)
    Remarque importante

    Notez que l'ensemble du tutoriel a été écrit pour PHP 7.4. Vous devez l'adapter vous-même pour vous placer en PHP 8.3 : php_xdebug-3.2.1-8.1-vs16-x86_64.dll

  2. Placez ce fichier dans le répertoire des extensions de PHP : C:\xampp\php\ext
  3. Ouvrez le fichier php.ini de configuration de PHP (voir partie précédente)
  4. Remplacez la ligne 
    output_buffering=4096
    par 
    output_buffering=Off
  5. Ajoutez le texte suivant à la fin du fichier php.ini 
    [XDebug]
zend_extension = "c:\xampp\php\ext\le_nom_du_fichier_dll_que_vous_venez_de_télécharger"
xdebug.remote_autostart = 1
xdebug.profiler_append = 0
xdebug.profiler_enable = 0
xdebug.profiler_enable_trigger = 0
xdebug.profiler_output_dir = "c:\xampp\tmp"
;xdebug.profiler_output_name = "cachegrind.out.%t-%s"
xdebug.remote_enable = 1
xdebug.remote_handler = "dbgp"
xdebug.remote_host = "127.0.0.1"
xdebug.remote_log = "c:\xampp\tmp\xdebug.txt"
xdebug.remote_port = 9000
xdebug.trace_output_dir = "c:\xampp\tmp"
xdebug.remote_cookie_expire_time = 36000
  6. Redémarrez le serveur Apache si vous utilisez PHP en mode Web

Configuration de MySQL / phpMyAdmin

Afin de travailler dans de bonnes conditions, vous allez créer un utilisateur MySQL et une ou plusieurs bases de données pour organiser vos développements.

Pour ceux qui souhaitent travailler sur Linux, consultez le TP de M. Gillard.

Création de compte utilisateur

Travail à réaliser
  1. Vérifiez dans XAMPP que les services Apache et MySQL sont bien démarrés MySQL
  2. Lancez votre navigateur Web est saisissez l'URL http://localhost/ MySQL
  3. Accédez à phpMyAdmin (en haut à droite) MySQL
  4. Rendez-vous dans l'onglet « Compte utilisateurs » MySQL
  5. Cliquez sur « Ajouter un compte d'utilisateur » MySQL
  6. Remplissez les champs « Nom d'utilisateur » (le login) et « Mot de passe » et n'oubliez pas de cocher les cases « Créer une base portant son nom et donner à cet utilisateur tous les privilèges sur cette base. » et « Accorder tous les privilèges à un nom passe-partout (utilisateur\_%). » avant de valider avec le bouton « Exécuter » en bas de page MySQL

Création de base de données

Travail à réaliser
  1. Rendez-vous dans l'onglet « Bases de données » MySQL
  2. Créez une base données dont le nom est de la forme « le-login-choisi_la-base-souhaitée » (l'élément important est le souligné « _ » entre le login et le nom de la base de données) MySQL et renouvelez cette opération pour chaque nouvelle base de données
  3. Constatez l'apparition de votre nouvelle base de données dans le panneau de navigation à gauche et l'affichage arborscent découlant du nommage particulier défini dans le point précédent MySQL

Protection de phpMyAdmin par authentification

Travail à réaliser
  • L'accès par défaut à phpMyAdmin dans XAMPP se fait avec l'utilisateur « root » sans mot de passe et ceci est inscrit dans la configuration de phpMyAdmin. Ouvrez le fichier de configuration de phpMyAdmin à l'aide de XAMPP MySQL et modifiez 
    $cfg['Servers'][$i]['auth_type'] = 'config';
    en 
    $cfg['Servers'][$i]['auth_type'] = 'cookie';
  • Acutalisez la vue de phpMyAdmin dans votre navigateur et constatez l'apparition du formulaire de connexion MySQL
  • Testez la connexion avec l'utilisateur précédemment créé MySQL

    • Configurer votre navigateur pour y intégrer un greffon de validation du code HTML

    Afin de fiabiliser vos productions de code HTML, manuelles ou en PHP, vous allez intégrer dans votre navigateur un greffon basé sur HTML Tidy qui permettra de valider votre code HTML avec un resultat équivalent à l'utilisation de https://validator.w3.org/ mais avec une bien plus grande simplicité.

    Travail à réaliser
    1. Rendez-vous sur https://www.gueury.com/mozilla/ Navigateur
    2. Choisissez la version compatible avec votre navigateur (Chrome ou Firefox) Navigateur
    3. Installez le greffon Navigateur
    4. Constatez l'ajout du greffon Navigateur
    5. Remarquez l'apparition de l'icône du greffon à droite de la barre de recherche du navigateur Navigateur
    6. Le greffon est accessible dans la barre de développement Navigateur
    Remarque importante

    Dans Chrome, le greffon ne vérifie la validité du code HTML que si la barre de développement est active.

    Remarque importante

    Le greffon ne semble pas supporter les URL comportant une marque de fragment « # », il convient donc de la supprimer de l'URL pour valider le code HTML.

    Travailler pendant une séance de PHP en ligne de commande

    Travail à réaliser
    1. Lancez Git Bash à l'aide du menu contextuel « Git Bash Here » dans le répertoire de votre projet Git Bash
    2. Votre terminal Git Bash est prêt pour votre séance Git Bash
    3. Vous pouvez lancer vos scripts PHP avec php votre_script.php Git Bash

    Travailler pendant une séance de PHP en mode serveur Web

    Travail à réaliser
    1. En début de TP, vous devrez lancer XAMPP et vérifier que votre serveur Web local Apache est actif Lancer XAMPP
    2. Accéder à http://localhost/ afin de vous assurer de son fonctionnement Vérifier Apache
    3. Cliquez ensuite sur « Explorer » dans XAMPP Localiser la racine de votre serveur Web local
    4. Une fenêtre d'explorateur de fichiers s'ouvre (logiquement dans C:\xampp), accédez au répertoire htdocs Racine de XAMPP
    5. Le répertoire htdocs est la racine du système de fichiers du serveur Web local, les fichiers et répertoires présents ne doivent pas être supprimés (ils sont utilisés par l'interface Web de XAMPP) Racine de votre serveur Web local