Prérequis

Grav est volontairement conçu avec peu de prérequis. Vous pouvez facilement exécuter Grav sur votre ordinateur local, ainsi que chez 99% des fournisseurs d'hébergement Web. Si vous avez un stylo à portée de main, notez les exigences suivantes du système Grav :

Serveur Web (Apache, Nginx, LiteSpeed, Lightly, IIS, etc.)
PHP 7.3.6 ou supérieur
hmm... c'est vraiment ça, (mais veuillez regarder les exigences PHP pour une expérience fluide) !

Grav est construit avec des fichiers texte brut pour votre contenu. Aucune base de données n'est nécessaire.

Un cache utilisateur PHP tel que APCu, Memcached ou Redis est fortement recommandé pour des performances optimales. Ne vous inquiétez pas cependant, ceux-ci font généralement déjà partie de votre pack d'hébergement !

Serveurs Web

Grav est si simple et polyvalent que vous n'avez même pas besoin d'un serveur Web pour l'exécuter. Vous pouvez l'exécuter directement à partir du serveur Web PHP intégré, tant que vous exécutez PHP 7.3.6 ou une version ultérieure.

Tester avec les serveurs Web intégrés est un moyen utile de vérifier une installation de Grav et d'effectuer un bref développement, mais il n'est pas recommandé pour un site en direct ou même pour des tâches de développement avancées. Nous avons décrit comment dans notre guide d'Installation.

Même si techniquement vous n'avez pas besoin d'un serveur Web autonome, il est préférable d'en exécuter un, même pour le développement local. Il existe de nombreuses options intéressantes :

Mac

MacOS 10.14 Mojave est déjà livré avec le serveur Web Apache et PHP 7.1, alors le travail est fait !
MAMP/MAMP Pro est livré avec Apache, MySQL et bien sûr PHP. C'est un excellent moyen de mieux contrôler la version de PHP que vous utilisez, de configurer des hôtes virtuels, ainsi que d'autres fonctionnalités utiles telles que la gestion automatique du DNS dynamique.
AMPPS est une pile logicielle de Softaculous permettant d'utiliser Apache, PHP, Perl, Python, .. Cela inclut tout ce dont vous avez besoin (et plus) pour le développement GRAV.
Brew Apache/PHP est une approche alternative qui permet une installation entièrement configurable avec différentes versions de PHP.

Windows

Laragon, environnement de développement universel portable, isolé, rapide et puissant pour PHP, Node.js, etc. Il est rapide, léger, facile à utiliser et à étendre.
XAMPP fournit Apache, PHP et MySQL dans un package simple.
EasyPHP fournit un pack d'hébergement Web personnel ainsi qu'une version développeur plus puissante.
MAMP pour Windows est un favori Mac de longue date, mais maintenant disponible pour Windows.
IIS avec PHP est un moyen rapide d'exécuter PHP sous Windows.
AMPPS est une pile logicielle de Softaculous permettant d'utiliser Apache, PHP, Perl, Python, .. Cela inclut tout ce dont vous avez besoin (et plus) pour le développement GRAV.
Linux Subsystem est un excellent moyen d'exécuter un environnement de type Linux sous Windows

Linux

De nombreuses distributions de Linux sont déjà livrées avec Apache et PHP intégrés. Si ce n'est pas le cas, la distribution fournit généralement un gestionnaire de packages à travers lequel vous pouvez les installer sans trop de tracas. Des configurations plus avancées doivent être étudiées à l'aide d'un bon moteur de recherche.

Prérequis pour Apache

Même si la plupart des distributions d'Apache sont livrées avec tout le nécessaire, par souci d'exhaustivité, voici une liste des modules Apache requis :

mod_rewrite
mod_ssl (si vous souhaitez exécuter Grav sous SSL).
mod_mpm_itk_module (si vous souhaitez exécuter Grav sous son propre compte utilisateur).

Vous devez également vous assurer que AllowOverride All est défini dans les blocs <Directory> et/ou <VirtualHost> afin que le fichier .htaccess soit traité correctement et que les règles de réécriture prennent effet.

Prérequis pour IIS

Bien qu'IIS soit considéré comme un serveur Web prêt à fonctionner et "prêt à l'emploi", certaines modifications doivent être apportées.

Pour faire fonctionner Grav sur un serveur IIS, vous devez installer URL Rewrite. Cela peut être accompli à l'aide de Microsoft Web Platform Installer à partir d'IIS. Vous pouvez également installer URL Rewrite en allant sur iis.net.

Prérequis pour PHP

La plupart des fournisseurs d'hébergement et même les configurations LAMP locales ont PHP préconfiguré avec tout ce dont vous avez besoin pour que Grav fonctionne "prêt à l'emploi". Cependant, certaines configurations Windows, et même les distributions Linux locales ou sur VPS (je vous laisse regarder Debian !) - sont livrées avec une compilation PHP très minimale. Par conséquent, vous devrez peut-être installer ou activer ces modules PHP :

curl (client pour la gestion des URL utilisé par GPM).
ctype (utilisé par symfony/yaml/Inline).
dom (utilisé par le fil d'actualité grav/admin).
gd (une bibliothèque graphique utilisée pour manipuler des images).
json (utilisé par Symfony/Composer/GPM).
mbstring (prise en charge des chaînes multioctets).
openssl (bibliothèque de sockets sécurisés utilisée par GPM).
session (utilisé par toolbox).
simplexml (utilisé par le fil d'actualité grav/admin).
xml (prise en charge XML).
zip prise en charge de l'extension zip (utilisée par GPM).

Pour activer le support openssl et (un)zip, vous devrez trouver dans le fichier php.ini de votre distribution Linux des lignes comme :

1 | ;extension=openssl.so
2 | ;extension=zip.so

et supprimez le point-virgule initial.

Modules optionnels

apcu pour des performances de cache accrues.
opcache pour des performances PHP accrues.
yaml PECL Yaml fournit un traitement yaml natif et peut augmenter considérablement les performances.
xdebug utile pour le débogage dans un environnement de développement.

Autorisations

Pour que Grav fonctionne correctement, votre serveur Web doit disposer des autorisations de fichiers appropriées pour écrire les journaux, des caches, etc. Lors de l'utilisation de la CLI (Interface en Ligne de Commande) ou du GPM (Gestionnaire de Package Grav), l'utilisateur exécutant PHP à partir de la ligne de commande doit également disposer des autorisations appropriées pour modifier les fichiers.

Par défaut, Grav s'installera, respectivement, avec les autorisations 644 et 755 pour les fichiers et les dossiers. La plupart des fournisseurs d'hébergement ont des configurations qui garantissent qu'un serveur Web exécutant PHP vous permettra de créer et de modifier des fichiers dans votre compte d'utilisateur. Cela signifie que Grav est prêt à l'emploi sur la grande majorité des fournisseurs d'hébergement.

Toutefois, si vous utilisez un serveur dédié ou même votre environnement local, vous devrez peut-être ajuster les autorisations pour vous assurer que votre utilisateur et votre serveur Web peuvent modifier les fichiers selon les besoins. Il existe plusieurs approches que vous pouvez adopter.

Dans un environnement de développement local, vous pouvez généralement configurer votre serveur Web pour qu'il s'exécute sous votre profil utilisateur. Ainsi, le serveur Web vous permettra toujours de créer et de modifier des fichiers.
Modifiez les autorisations de groupe sur tous les fichiers et dossiers afin que le groupe du serveur Web ait un accès en écriture aux fichiers et dossiers tout en conservant les autorisations standard. Cela nécessite quelques commandes pour que cela fonctionne.

Tout d'abord, vérifiez avec quel utilisateur Apache s'exécute en exécutant la commande suivante :

$ | ps aux | grep -v root | grep apache | cut -d\ -f1 | sort | uniq

Maintenant, découvrez à quel groupe appartient cet utilisateur en exécutant cette commande (remarque : ajustez USERNAME avec le nom d'utilisateur apache que vous avez trouvé dans la commande précédente)

$ | groups USERNAME

(remarque : ajustez GROUP pour qu'il corresponde au groupe sous lequel votre apache s'exécute, trouvé dans la commande précédente. [www-data, apache, nobody, etc.]) :

1 | chgrp -R GROUP .
2 | find . -type f | xargs chmod 664
3 | find ./bin -type f | xargs chmod 775
4 | find . -type d | xargs chmod 775
5 | find . -type d | xargs chmod +s
6 | umask 0002

Si vous avez besoin d'invoquer des autorisations de superutilisateur, vous exécuterez find … | sudo xargs chmod … à la place.

Outils recommandés

PhpStorm

Grav est développé à l'aide de PhpStorm, ce qui en fait le meilleur IDE pour Grav. Cependant, cela ne vient pas comme çà.

PhpStorm est le mieux adapté aux développeurs PHP, y compris les personnes qui écrivent des plugins Grav compliqués. Il offre une compilation de code automatisée pour Grav (il vous suffit d'ajouter Grav et tout plugin que vous utilisez dans les inclusions), et de nombreux autres outils pour aider au développement du code. Il prend également en charge le formatage de twig, yaml, html, js, scss et tailwind.

Éditeurs de texte

Bien que vous puissiez vous en sortir avec le Bloc-notes, Textedit, Vi ou tout autre éditeur de texte par défaut fourni avec votre plateforme, nous vous recommandons d'utiliser un bon éditeur de texte avec coloration syntaxique pour faciliter les choses. Voici quelques options recommandées :

Visual Studio Code - Semblable à Atom, il est construit à l'aide d'Electron, de Node, ainsi que de HTML/CSS. Il est assez léger et dispose de nombreux plugins, dont un très bon support pour PHP et JavaScript. Il s'agit de l'éditeur actuellement recommandé pour développer pour Grav.
Atom - MacOS/Windows/Linux - Un nouvel éditeur développé par Github. C'est gratuit et open source. Il est similaire à Sublime, mais n'a pas encore la profondeur des plugins disponibles.
SublimeText - MacOS/Windows/Linux - Un éditeur de développeur commercial, mais qui vaut bien le prix. Très puissant surtout combiné avec des plugins tels que Markdown Extended, Pretty YAML et PHP-Twig.
Notepad++ - Windows - Un éditeur gratuit et très populaire pour Windows.
Bluefish - MacOS/Windows/Linux - Un éditeur de texte open source gratuit destiné aux programmeurs et aux développeurs Web.
Kate - MacOS/Windows/Linux - Un éditeur de texte et outil de programmation open source léger mais puissant et polyvalent, prenant en charge la surbrillance dans plus de 300 langues (y compris Markdown).

Éditeurs Markdown

Une autre option si vous travaillez principalement avec la création de contenu consiste à utiliser un éditeur Markdown dédié. Ceux-ci sont souvent très centrés sur le contenu et fournissent généralement un aperçu en direct de votre contenu rendu au format HTML. Il y en a littéralement des centaines, mais certaines bonnes options incluent :

MacDown - MacOS - Gratuit, un éditeur Markdown open source simple et léger.
LightPaper - MacOS - 17,99 $, propre, puissant. Notre éditeur Markdown de choix sur Mac. Obtenez 25 % de réduction avec le code de réduction : GET_GRAV_25
MarkDrop - MacOS - 5 $, mais super propre et prise en charge Droplr intégrée.
MarkdownPad - Windows - Versions gratuites et Pro. Posséde même la prise en charge du front-matter YAML. Une excellente solution pour les utilisateurs de Windows.
Mark Text - Éditeur Markdown gratuit et open source pour Windows / Linux / MacOS.

Client FTP

Bien qu'il existe de nombreuses façons de déployer Grav, il vous suffit fondamentalement de copier votre site local sur votre hébergeur. La façon la plus simple de le faire est d'utiliser un client FTP. Il en existe de nombreux, mais certains sont recommandés :

Transmit - MacOS - Le client FTP/SFTP de facto sur MacOS. Facile à utiliser, rapide, synchronisation des dossiers et à peu près tout ce que vous pourriez demander.
FileZilla - MacOS/Windows/Linux - Probablement la meilleure option pour les utilisateurs Windows et Linux. Gratuit et très puissant (mais très moche sur Mac !).
Cyberduck - MacOS/Windows - Une option gratuite décente pour les utilisateurs MacOS et Windows. Pas aussi complet que les autres.
ForkLift - MacOS - Une alternative solide à Transmit, et légèrement moins chère au démarrage.

Git

Si vous exécutez le système de contrôle de version distribué Git sur vos environnements de développement et de serveur, vous pouvez configurer un flux de travail simple via un service Git hébergé tel que Github ou GitLab. C'est un peu plus de travail à configurer, mais cela fournit un flux de travail plus propre et plus robuste qui s'occupe des sauvegardes pour vous. N'essayez ceci que si vous êtes à l'aise avec Git et ses outils clients.

Nous fournissons plus de détails sur l'utilisation de Git dans votre flux de travail ultérieurement dans la section Déploiement avec Git du chapitre Serveurs Web et hébergement.