Objectif du tutoriel

L’objectif est de préparer un environnement local propre pour travailler sur des projets PHP, WordPress ou WooCommerce. Laragon permet de lancer rapidement Apache, MySQL et PHP sur votre ordinateur, sans configuration lourde.

À la fin de ce tutoriel, vous saurez installer Laragon, accéder à vos projets en local, installer phpMyAdmin, configurer la connexion MySQL et changer de version de PHP selon vos besoins.

Environnement local :
- Laragon installé
- Apache ou Nginx lancé
- MySQL lancé
- phpMyAdmin accessible
- Plusieurs versions de PHP disponibles
- Projets locaux rangés dans C:\laragon\www\

Installer Laragon

Commencez par installer Laragon sur votre ordinateur. L’installation classique suffit largement pour travailler en local. Par défaut, Laragon s’installe généralement dans le dossier C:\laragon.

C:\laragon\

Une fois installé, ouvrez Laragon puis cliquez sur Start All. Cela démarre les services nécessaires, notamment le serveur web et MySQL.

Apache ou Nginx : démarré
MySQL ou MariaDB : démarré

Comprendre les dossiers importants

Laragon organise les fichiers de manière simple. Le dossier le plus important pour vos sites est www. C’est ici que vous placez vos projets locaux.

C:\laragon\
├── bin\
│   ├── php\
│   ├── mysql\
│   └── apache\
├── etc\
│   └── apps\
└── www\
    └── mes-projets\

Exemple : si vous créez un dossier C:\laragon\www\monsite, vous pourrez généralement y accéder depuis votre navigateur.

http://monsite.test
ou
http://localhost/monsite

Installer phpMyAdmin manuellement

phpMyAdmin permet de gérer vos bases MySQL depuis une interface web. Si votre version de Laragon ne l’intègre pas directement, vous pouvez l’ajouter manuellement.

Téléchargez phpMyAdmin au format ZIP depuis le site officiel, puis décompressez-le dans le dossier des applications Laragon.

C:\laragon\etc\apps\phpMyAdmin\

Attention : le dossier phpMyAdmin doit contenir directement les fichiers de phpMyAdmin. Il ne faut pas avoir un sous-dossier supplémentaire inutile.

C:\laragon\etc\apps\phpMyAdmin\
├── index.php
├── config.sample.inc.php
├── libraries\
├── themes\
└── vendor\

Créer le fichier de configuration phpMyAdmin

Dans le dossier de phpMyAdmin, copiez le fichier config.sample.inc.php puis renommez la copie en config.inc.php.

config.sample.inc.php
à copier / renommer en :
config.inc.php

Ouvrez ensuite config.inc.php et renseignez une clé secrète dans blowfish_secret. Cette clé sert notamment à sécuriser les cookies de connexion de phpMyAdmin.

$cfg['blowfish_secret'] = 'sycow-laragon-phpmyadmin-secret-2026-demo';

Vous pouvez remplacer la valeur par votre propre texte, idéalement assez long.

Corriger l’erreur AllowNoPassword

Par défaut, Laragon utilise souvent l’utilisateur MySQL root sans mot de passe. phpMyAdmin peut refuser cette connexion et afficher une erreur indiquant que la configuration interdit une connexion sans mot de passe.

Pour corriger cela en local, ajoutez ou vérifiez cette ligne dans la configuration serveur de phpMyAdmin.

$i++;

$cfg['Servers'][$i]['auth_type'] = 'cookie';
$cfg['Servers'][$i]['host'] = '127.0.0.1';
$cfg['Servers'][$i]['compress'] = false;
$cfg['Servers'][$i]['AllowNoPassword'] = true;

Cette configuration est acceptable pour un environnement local. Elle ne doit pas être utilisée telle quelle sur un serveur en production.

Accéder à phpMyAdmin

Une fois phpMyAdmin installé et configuré, redémarrez Laragon avec Restart All. Ouvrez ensuite phpMyAdmin depuis votre navigateur.

http://localhost/phpmyadmin

Les identifiants par défaut sont généralement les suivants avec Laragon.

Utilisateur : root
Mot de passe : laisser vide

Si la connexion fonctionne, vous pouvez créer et gérer vos bases de données locales depuis phpMyAdmin.

Installer plusieurs versions de PHP

Laragon permet d’ajouter plusieurs versions de PHP. C’est très pratique si vous travaillez sur différents sites, notamment des sites WordPress anciens ou des projets récents.

Les versions de PHP doivent être placées dans le dossier suivant.

C:\laragon\bin\php\

Téléchargez une version Windows de PHP, puis décompressez le dossier dans C:\laragon\bin\php\. Avec Apache, choisissez en général une version x64 Thread Safe.

C:\laragon\bin\php\
├── php-8.1.33-Win32-vs16-x64
├── php-8.2.29-Win32-vs16-x64
├── php-8.3.23-Win32-vs17-x64
└── php-8.4.10-Win32-vs17-x64

Changer de version de PHP dans Laragon

Une fois vos versions de PHP ajoutées, vous pouvez changer de version directement depuis l’interface de Laragon.

Menu
→ PHP
→ Version
→ Choisir la version souhaitée

Après le changement, redémarrez Laragon pour que la nouvelle version soit bien prise en compte.

Menu
→ Restart All

Vous pouvez vérifier la version active dans le terminal.

php -v

Vérifier PHP avec phpinfo

Pour vérifier la version utilisée par le serveur web, créez un fichier phpinfo.php dans un projet local.

<?php
phpinfo();

Placez ce fichier dans un dossier de test, par exemple C:\laragon\www\test\phpinfo.php, puis ouvrez-le dans le navigateur.

http://localhost/test/phpinfo.php

La page affichera la version de PHP, les extensions actives et la configuration utilisée par votre serveur local.

Créer une première base dans phpMyAdmin

Depuis phpMyAdmin, vous pouvez créer une base de données pour votre projet. Utilisez de préférence l’encodage utf8mb4_unicode_ci pour bien gérer les accents et les caractères spéciaux.

CREATE DATABASE IF NOT EXISTS test_laragon
CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;

Cette commande crée une base nommée test_laragon. Vous pourrez ensuite l’utiliser dans vos projets PHP ou WordPress.

Tester la connexion PHP à MySQL

Pour vérifier que PHP communique bien avec MySQL, créez un petit fichier de test.

<?php
declare(strict_types=1);

try {
    $pdo = new PDO(
        'mysql:host=127.0.0.1;dbname=test_laragon;charset=utf8mb4',
        'root',
        '',
        [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        ]
    );

    echo 'Connexion réussie à MySQL.';
} catch (PDOException $e) {
    echo 'Erreur de connexion MySQL.';
}

Si le message de réussite s’affiche, votre environnement local est correctement configuré.

Conseils pour WordPress et WooCommerce

Pour travailler confortablement sur des sites WordPress, gardez plusieurs versions de PHP disponibles. Cela permet de tester rapidement la compatibilité d’un thème, d’un plugin ou d’un ancien site client.

PHP 8.1 : compatibilité anciens sites
PHP 8.2 : bon compromis pour beaucoup de projets
PHP 8.3 : recommandé pour les projets récents
PHP 8.4 : tests et anticipation

Avant de migrer un site client vers une nouvelle version de PHP, testez toujours le site en local. Vérifiez l’administration, le panier, le paiement, les formulaires et les fonctionnalités importantes.

Erreurs courantes

Voici les problèmes les plus fréquents lors de la configuration de Laragon, phpMyAdmin et PHP.

Problème :
http://localhost/phpmyadmin ne fonctionne pas.

Causes possibles :
- Le dossier phpMyAdmin n’est pas dans C:\laragon\etc\apps\
- Les fichiers sont dans un sous-dossier en trop
- Laragon n’a pas été redémarré

Solution :
Vérifier le chemin puis faire Restart All.

Problème :
La configuration interdit une connexion sans mot de passe.

Solution :
Ajouter cette ligne dans config.inc.php :
$cfg['Servers'][$i]['AllowNoPassword'] = true;

Problème :
php -v affiche une autre version que celle attendue.

Solution :
- Changer la version dans Menu → PHP
- Redémarrer Laragon
- Fermer et rouvrir le terminal

Checklist finale

Avant de commencer à travailler sur vos projets, vérifiez rapidement les points suivants.

1. Laragon est installé dans C:\laragon\
2. Apache ou Nginx est démarré
3. MySQL ou MariaDB est démarré
4. Vos projets sont dans C:\laragon\www\
5. phpMyAdmin est installé dans C:\laragon\etc\apps\phpMyAdmin\
6. config.inc.php existe dans le dossier phpMyAdmin
7. AllowNoPassword est activé pour root sans mot de passe
8. http://localhost/phpmyadmin fonctionne
9. Plusieurs versions de PHP sont disponibles si besoin
10. php -v affiche la bonne version

Une fois cette checklist validée, votre poste de développement local est prêt pour travailler proprement.

Conclusion

Vous disposez maintenant d’un environnement local simple et efficace. Laragon sert à lancer vos projets, phpMyAdmin permet de gérer vos bases de données, et les versions de PHP peuvent être changées selon les besoins de chaque site.

Cette base suffit pour développer, tester ou dépanner la majorité des projets PHP, WordPress et WooCommerce en local.

Laragon = serveur local
phpMyAdmin = gestion des bases MySQL
C:\laragon\www\ = dossier des projets
C:\laragon\etc\apps\phpMyAdmin\ = dossier phpMyAdmin
C:\laragon\bin\php\ = dossier des versions PHP

Accéder au serveur depuis le réseau local

Par défaut, votre serveur Laragon est accessible via localhost ou 127.0.0.1. Si vous souhaitez accéder à votre site depuis un autre ordinateur, un téléphone ou une tablette présents sur le même réseau, il est nécessaire d'autoriser les connexions HTTP dans le pare-feu Windows.

Ouvrez l'Invite de commandes ou PowerShell en tant qu'administrateur puis exécutez la commande suivante :

netsh advfirewall firewall add rule name="Laragon Apache HTTP" dir=in action=allow protocol=TCP localport=80

Si vous utilisez également le HTTPS, ajoutez également cette règle :

netsh advfirewall firewall add rule name="Laragon Apache HTTPS" dir=in action=allow protocol=TCP localport=443

Une fois les règles ajoutées, redémarrez Laragon puis accédez à votre site en utilisant l'adresse IP de votre ordinateur, par exemple :

http://192.168.1.43

Cette manipulation est particulièrement utile pour tester un site WordPress ou WooCommerce directement depuis un smartphone, une tablette ou un autre ordinateur connecté au même réseau.

Activer le HTTPS (SSL) en local

Certains projets nécessitent l'utilisation du protocole HTTPS, notamment WordPress, WooCommerce, les Progressive Web Apps (PWA), les Service Workers ou encore certaines API externes. Laragon permet d'utiliser facilement un certificat SSL pour travailler dans des conditions proches d'un serveur de production.

Commencez par activer le SSL dans Laragon puis redémarrez tous les services.

Laragon
→ Apache
→ SSL
→ Enabled

Puis :
Stop All
Start All

Si vous souhaitez accéder au serveur depuis un autre appareil de votre réseau, pensez également à autoriser le port HTTPS (443) dans le pare-feu Windows.

netsh advfirewall firewall add rule name="Laragon Apache HTTPS" dir=in action=allow protocol=TCP localport=443

Pour profiter pleinement du HTTPS, il est recommandé d'utiliser les domaines créés automatiquement par Laragon (par exemple monsite.test) plutôt que l'adresse IP de votre ordinateur.

https://monsite.test

En utilisant directement une adresse IP (par exemple https://192.168.1.43), le navigateur peut afficher une alerte de sécurité. Le certificat SSL étant associé au nom de domaine, il ne correspond généralement pas à l'adresse IP du poste.

Pour un développement local classique, il est donc conseillé d'utiliser les domaines .test générés par Laragon. Vous bénéficierez ainsi d'un environnement HTTPS très proche d'un hébergement réel.

Comment puis-je vous aider ?

Travaux pratiques PHP SQL