Installation

L'installation de Grav est un processus trivial. En fait, il n'y a pas vraiment d'installation. Vous avez plusieurs options pour installer Grav. La première - et la plus simple - consiste à télécharger l'archive zip et à l'extraire. La deuxième méthode consiste à installer avec Composer. La troisième méthode consiste à cloner le projet source directement à partir de GitHub, puis à exécuter une commande de script incluse pour installer les dépendances nécessaires. Il existe d'autres façons d'exécuter des scripts groupés.

Vérifier la version PHP

Grav est incroyablement facile à installer et à faire fonctionner. Assurez-vous d'avoir au moins la version PHP 7.3.6+ en allant sur le terminal et en tapant php -v :

$ | php-v
  | PHP 7.3.18 (cli) (built : Jun 5 2020 11:06:30) ( NTS )
  | Copyright (c) 1997-2018 The PHP Group
  | Zend Engine v3.3.18, Copyright (c) 1998-2018 Zend Technologies
  |     with Zend OPcache v7.3.18, Copyright (c) 1999-2018, by Zend Technologies

Option 1 : Installer à partir du package ZIP

Le moyen le plus simple d'installer Grav est de télécharger le package ZIP et de l'extraire :

  1. Téléchargez le dernier package Grav ou Grav + Admin.
  2. Extrayez le fichier ZIP dans le webroot de votre serveur Web, par ex. ~/webroot/grav
Il existe des packages Skeleton disponibles, qui incluent le système principal Grav, des exemples de pages, des plugins et la configuration. Ils sont un excellent moyen de commencer; tout ce que vous avez à faire est de télécharger le Skeleton que vous préférez et de suivre les étapes ci-dessus.

Vous pouvez également télécharger n'importe quelle installation pré-emballée d'une version étiquetée à partir de getgrav.org. Utilisez le format https://getgrav.org/download/TYPE/PACKAGE/VERSION.

Si vous avez téléchargé le fichier ZIP et que vous prévoyez ensuite de le déplacer vers votre racine Web, veuillez déplacer le DOSSIER ENTIER car il contient plusieurs fichiers cachés (tels que .htaccess) qui ne seront pas sélectionnés par défaut. L'omission de ces fichiers cachés peut causer des problèmes lors de l'exécution de Grav.

Option 2 : Installer avec Composer

La méthode alternative consiste à installer Grav avec composer :

$ | composer create-project getgrav/grav ~/webroot/grav

Si vous souhaitez découvrir la version à la pointe de la technologie de Grav, ajoutez 1.x-dev comme paramètre supplémentaire :

$ | composer create-project getgrav/grav ~/webroot/grav 1.x-dev

Installer depuis GitHub

Une autre méthode consiste à cloner Grav à partir du référentiel GitHub, puis à exécuter un simple script d'installation de dépendance :

  1. Clonez le référentiel Grav de GitHub dans un dossier de la racine Web de votre serveur, par ex. ~/webroot/grav. Lancez un terminal ou une console et accédez au dossier Webroot :
$ | cd ~/webroot
$ | git clone -b master https://github.com/getgrav/grav.git
  1. Installez les dépendances du fournisseur via composer :
$ | cd ~/webroot/grav
$ | composer install --no-dev -o
  1. Installez les dépendances du plugin et du thème en utilisant l'application Grav CLI bin/grav 
$ | cd ~/webroot/grav
$ | bin/grav install

Cela clonera automatiquement les dépendances requises de GitHub directement dans cette installation Grav.

Options supplémentaires

Installer avec Docker

Docker est un moyen extrêmement efficace de démarrer des platesformes et des services sur les serveurs et les environnements locaux. Si vous configurez plusieurs environnements qui doivent être identiques ou si vous travaillez en collaboration, il offre un moyen simple d'assurer la cohérence entre les installations. Si vous développez plusieurs sites Grav, vous pouvez rationaliser leur configuration à l'aide de Docker.

Des images Docker stables sont disponibles qui utilisent les serveurs Web Apache (l'image officielle), Nginx et Caddy. Si vous recherchez, vous trouverez plus que vous pouvez essayer. Avec n'importe quelle image, assurez-vous de créer des volumes pour conserver les dossiers user, backups et logs de Grav. (Les sauvegardes et les journaux sont facultatifs si vous n'avez pas besoin de conserver ces données.)

Installer sur Cloudron

Cloudron est une solution complète pour exécuter des applications sur votre serveur et les maintenir à jour et sécurisées. Sur votre Cloudron, vous pouvez installer Grav en quelques clics. Si vous hébergez plusieurs sites, vous pouvez les installer complètement isolés les uns des autres sur le même serveur.

Le code source du paquet peut être trouvé ici.

Installer via Linode Marketplace

Si vous utilisez des serveurs Linode, il existe une méthode simple et documentée utilisant Linode Marketplace. Cela mettra en place un nouveau site Grav sur un nouveau serveur virtuel Linode dédié. Le serveur virtuel encourra des frais périodiques.

Serveurs Web

Apache/IIS/Nginx

Utiliser Grav avec un serveur Web tel qu'Apache, IIS ou Nginx est aussi simple que d'extraire Grav dans un dossier sous webroot. Tout ce dont il a besoin pour fonctionner est PHP 7.3.6 ou supérieur, vous devez donc vous assurer que votre instance de serveur répond à cette exigence. Vous trouverez plus d'informations sur les prérequis de Grav dans le chapitre des prérequis de ce guide.

Si votre webroot est, par exemple, ~/public_html, vous pouvez l'extraire dans ce dossier et y accéder via http://localhost. Si vous l'avez extrait dans ~/public_html/grav, vous y accéderez via http://localhost/grav.

Chaque serveur Web doit être configuré. Grav est livré avec .htaccess par défaut, pour Apache, et est livré avec certains fichiers de configuration de serveur par défaut, pour nginx, caddy server, iis et lighttpd. Utilisez-les en conséquence si nécessaire.

Exécuter Grav avec le serveur Web PHP intégré

Vous pouvez exécuter Grav à l'aide d'une simple commande depuis Terminal / Invite de commandes en utilisant le serveur PHP intégré disponible tant que PHP est installé.

Tout ce que vous avez à faire est d'accéder à la racine de votre installation Grav à l'aide du terminal ou de l'invite de commande et de taper bin/grav server.

Bien que techniquement tout ce dont vous avez besoin est PHP installé, si vous installez l'application Symfony CLI, le serveur fournira un certificat SSL afin que vous puissiez utiliser https:// et utiliser PHP-FPM pour de meilleures performances.

La saisie de cette commande vous présentera une sortie semblable à la suivante :

$ | bin/grav server
  |
  | Grav Web Server
  | ===============
  |
  |Tailing Web Server log file (/Users/joeblow/.symfony/log/ 96e710135f52930318e745e901e4010d0907cec3.log)
  | Tailing PHP-FPM log file (/Users/joeblow/.symfony/log/96e710135f52930318e745e901e4010d0907cec3/53fb8ec204547646acb3461995e4da5a54cc7575.log)
  | Tailing PHP-FPM log file (/Users/joeblow/.symfony/log/96e710135f52930318e745e901e4010d0907cec3/53fb8ec204547646acb3461995e4da5a54cc7575.log)
  | 
  | [OK] Web server listening
  | The Web server is using PHP FPM 8.0.8
  | https://127.0.0.1:8000
  | 
  | [Web Server ] Jul 30 14:54:53 |DEBUG  | PHP    Reloading PHP versions
  | [Web Server ] Jul 30 14:54:54 |DEBUG  | PHP    Using PHP version 8.0.8 (from default version in $PATH)
  | [PHP-FPM    ] Jul  6 14:40:17 |NOTICE | FPM    fpm is running, pid 64992
  | [PHP-FPM    ] Jul  6 14:40:17 |NOTICE | FPM    ready to handle connections
  | [PHP-FPM    ] Jul  6 14:40:17 |NOTICE | FPM    fpm is running, pid 64992
  | [PHP-FPM    ] Jul  6 14:40:17 |NOTICE | FPM    ready to handle connections
  | [Web Server ] Jul 30 14:54:54 |INFO   | PHP    listening path="/usr/local/Cellar/php/8.0.8_2/sbin/php-fpm" php="8.0.8" port=65140
  | [PHP-FPM    ] Jul 30 14:54:54 |NOTICE | FPM    fpm is running, pid 73709
  | [PHP-FPM    ] Jul 30 14:54:54 |NOTICE | FPM    ready to handle connections
  | [PHP-FPM    ] Jul 30 14:54:54 |NOTICE | FPM    fpm is running, pid 73709
  | [PHP-FPM    ] Jul 30 14:54:54 |NOTICE | FPM    ready to handle connections

Votre terminal vous donnera également des mises à jour en temps réel de toute activité sur ce serveur. Vous pouvez copier l'URL fournie dans la ligne [OK] Web server listening et la coller dans le navigateur de votre choix pour accéder à votre site, y compris l'administrateur.

https://127.0.0.1:8000

Il s'agit d'un outil utile pour un développement rapide et ne doit pas être utilisé à la place d'un serveur Web dédié tel qu'Apache ou Nginx.

Installation réussie

La première fois qu'il se charge, Grav pré-compile certains fichiers. Si vous actualisez maintenant votre navigateur, vous obtiendrez une version en cache plus rapide.

installation réussie

Dans les exemples précédents, $ représente l'invite de commande. Cela peut sembler différent sur différentes plates-formes.

Par défaut, Grav est livré avec des exemples de pages pour vous donner un point de départ. Votre site est déjà entièrement fonctionnel et vous pouvez le configurer, ajouter du contenu, l'étendre ou le personnaliser autant que vous le souhaitez.

Problèmes d'installation et de configuration

Si des problèmes sont découverts lors du chargement initial de la page (ou après un événement de vidage du cache), une page d'erreur peut s'afficher :

problème

Veuillez consulter la section Dépannage pour obtenir de l'aide concernant des problèmes spécifiques.

Si vous rencontrez des problèmes avec les autorisations de fichiers, veuillez consulter la documentation de dépannage des autorisations. Vous pouvez également consulter la documentation des guides d'hébergement" qui contient des instructions spécifiques pour divers environnements d'hébergement.

Mises à jour Grav

Pour garder votre site à jour, veuillez lire Mise à jour de Grav & Plugins.