01 — Installer Grav 2 et préparer un environnement propre
Vérifier PHP, installer Grav 2 avec son administration et obtenir un environnement de test propre avant de toucher au design.
Avant de commencer
- Avoir PHP 8.3.11 ou plus récent pour Grav 2.
- Pouvoir extraire un ZIP et ouvrir un terminal.
Vérifier la version PHP
Grav 2 demande PHP 8.3.11 ou plus récent. Vérifie d'abord le PHP du terminal et, sur l'hébergement, la version réellement utilisée par le domaine.
php -v- La version est au moins PHP 8.3.11.
Télécharger et extraire Grav
Pour apprendre, utilise un paquet Grav 2 avec administration afin de découvrir immédiatement le back-office.
Extrais-le dans un dossier dédié : ne mélange pas cette installation avec un autre projet.
grav-demo/- Je vois notamment index.php, system/ et user/.
Servir le site en local
Pour l'apprentissage, tu peux utiliser le serveur PHP intégré ou la méthode locale recommandée par la version Grav téléchargée.
Le serveur PHP intégré est uniquement destiné au développement et aux tests.
php -S 127.0.0.1:8000 system/router.php- La page d'accueil s'affiche sur http://127.0.0.1:8000/.
Découvrir l'administration
Ouvre /admin, crée le compte administrateur de test puis explore Pages, Plugins, Themes et Configuration.
Grav 2 utilise une administration moderne alimentée par l'API Grav.
http://127.0.0.1:8000/admin- Je peux me connecter à /admin.
- Je sais où trouver Pages, Plugins, Themes et Configuration.
Créer un premier point de retour
Avant tes essais, initialise Git ou fais une copie du dossier. Tu dois pouvoir revenir à l'état initial sans réinstaller.
git init
git add .
git commit -m "Initial Grav install"- J'ai un point de retour avant mes premières modifications.
🧯 Erreurs fréquentes
Grav refuse de démarrer à cause de PHP
Cause probable : Version PHP trop ancienne ou mauvais binaire utilisé
Correctif : Passer à PHP 8.3.11+ et revérifier le terminal ainsi que le serveur web.
La page /admin ne fonctionne pas
Cause probable : Paquet sans administration, Admin2 absent/inactif ou réécriture URL incorrecte
Correctif : Vérifier le paquet choisi, les plugins et la configuration du serveur web.
Notes
- Le serveur PHP intégré est un outil de développement, pas une configuration de production.
Sources de vérification
Ces liens servent à recontrôler le tuto quand l'outil ou l'hébergeur évolue.
Historique de la fiche
L'historique détaillé reste aussi disponible dans Git.