Installation de l’environnement de développement

Avant de plonger dans Drupal, nous allons vous guider à travers le processus d’installation de votre environnement de développement. Vous apprendrez à configurer un environnement Docker pour Drupal, à choisir une surcouche Docker adaptée à vos besoins, et à préparer votre système pour travailler efficacement avec Drupal.

1. Prérequis système

Il est essentiel de vous assurer que votre système satisfait aux exigences minimales. Les prérequis système varient en fonction de votre système d’exploitation. Assurez-vous donc que votre machine répond à ces exigences.

a. Prérequis généraux

Système d’exploitation : votre système d’exploitation doit être compatible avec Docker. Drupal 10 est conçu pour fonctionner sur une variété de systèmes, notamment Windows, macOS et diverses distributions Linux.
Processeur : un processeur 64 bits est recommandé pour des performances optimales.
Mémoire vive (RAM) : le minimum requis est de 2 Go de RAM, mais 4 Go ou plus sont recommandés pour un développement fluide. Drupal est plus efficace avec une RAM supérieure, surtout si vous prévoyez de travailler sur des sites web complexes.
Espace disque : vous aurez besoin d’espace disque pour les images Docker, vos projets Drupal, et les fichiers temporaires. Une quantité minimale d’espace disque recommandée est d’environ 20 Go, mais plus d’espace est préférable, surtout si vous travaillez sur plusieurs projets.

b. Prérequis par système d’exploitation

Windows : si vous utilisez Windows, assurez-vous que vous utilisez Windows 11 ou Windows 10 (Professionnel, Entreprise ou Éducation). De plus, Windows Subsystem for Linux 2 (WSL2) est requis pour exécuter Docker sur Windows.
macOS : les dernières versions de macOS sont généralement compatibles avec Docker. Assurez-vous de disposer d’une version récente de macOS.
Linux : si vous utilisez Linux, vous pouvez installer Docker sur la plupart des distributions Linux. Cependant, la configuration exacte peut varier en fonction de votre distribution. Assurez-vous de suivre les instructions spécifiques...

Installation de Drupal 10

La création d’un environnement de développement optimisé avec Docker est la première étape pour travailler sur un projet Drupal 10. Une fois cette infrastructure en place, il est temps d’installer Drupal 10 pour commencer à construire votre site web.

Cette section vous guidera à travers le processus d’installation de Drupal 10, en mettant l’accent sur les meilleures pratiques et les options de configuration essentielles. Vous découvrirez comment utiliser Composer pour créer un nouveau projet Drupal, comment gérer la structure de votre projet, et comment installer Drush, un outil puissant pour la gestion de votre site Drupal.

Nous aborderons également les concepts de site simple et multisite, ainsi que les paramètres de configuration clés pour personnaliser votre environnement de développement.

1. Préparation de DDEV

Avant de commencer à travailler sur votre projet Drupal 10 avec DDEV, il est essentiel de configurer correctement votre environnement local. Suivez ces étapes pour préparer DDEV à accueillir votre site Drupal.

a. Créez un répertoire pour votre projet

Tout d’abord, créez un répertoire dédié à votre projet Drupal 10. Vous pouvez choisir n’importe quel nom pour ce répertoire. Utilisons my-drupal10-site à des fins d’exemple. Ouvrez votre terminal et exécutez les commandes suivantes :

# Create new folder. 
$ mkdir my-drupal10-site 
# Go inside the fresh folder.  
$ cd my-drupal10-site

Cela créera un répertoire vide prêt à accueillir votre site Drupal.

b. Configuration de DDEV

DDEV propose une configuration simple via la ligne de commande pour les projets Drupal. Assurez-vous que vous êtes toujours dans le répertoire de votre projet (my-drupal10-site) et exécutez les commandes DDEV suivantes pour configurer votre environnement :

# Configure DDEV project. 
$ ddev config --project-type=drupal10 --docroot=web 
-create-docroot

ddev config : cette commande permet de configurer un projet DDEV.
--project-type=drupal10 : elle spécifie que vous créez un projet Drupal 10.
--docroot=web : elle indique que le répertoire racine de votre site Drupal se nomme "web"....

Répertoires spéciaux

Lors de la gestion d’un site Drupal 10, vous aurez besoin de configurer divers répertoires spéciaux pour stocker des fichiers temporaires, publics, privés, ainsi que des fichiers de configuration.

Ces répertoires jouent un rôle essentiel dans le fonctionnement de votre site. Dans cette section, nous allons aborder l’objectif de chacun de ces répertoires et comment les configurer dans votre fichier settings.php.

1. Fichiers temporaires

Le répertoire des fichiers temporaires dans Drupal est l’emplacement de votre infrastructure où le noyau Drupal et les modules contribués téléchargent des fichiers lors de leur installation ou pour effectuer divers traitements.

Il convient généralement, pour éviter toute erreur de configuration de Drupal, de créer manuellement ce répertoire à l’emplacement que vous avez défini dans le fichier settings.php.

// Define temporary files directory. 
$settings['file_temp_path'] = '../tmp';

Le répertoire tmp sera donc placé directement à la racine du projet.

2. Fichiers publics

Le répertoire des fichiers publics est l’emplacement où vous stockerez les fichiers accessibles au public, tels que les images, les fichiers CSS et les fichiers JavaScript.

Par défaut, il est généralement situé...

Modules Drupal

Les modules Drupal sont des extensions logicielles qui ajoutent des fonctionnalités supplémentaires à votre site web. Drupal 10 est livré avec un ensemble de modules de base, mais vous aurez souvent besoin d’ajouter des modules supplémentaires pour répondre à des besoins spécifiques.

Les modules Drupal sont libres et gratuits, mais certains peuvent nécessiter l’accès à des services tiers qui peuvent être payants, par exemple, des services de géolocalisation basée sur l’adresse.

Cette section vous guidera à travers l’installation de modules Drupal, en mettant l’accent sur l’utilisation de Composer pour simplifier le processus.

1. Installer un module via Composer

Pour installer des modules Drupal, Composer est l’outil recommandé. Voici comment vous pouvez installer un module Drupal à l’aide de Composer.

Assurez-vous d’être dans le répertoire de votre projet Drupal, puis utilisez la commande Composer suivante pour rechercher le module souhaité.

Remplacez module_name par le nom du module que vous souhaitez installer. Tous les modules et thèmes Drupal sont disponibles gratuitement sur Drupal.org.

# Example command to install module through composer. 
$ composer require drupal/module_name

Par exemple, pour installer le module Admin Toolbar, vous utiliserez la commande suivante :

# Install admin_toolbar module through composer. 
$ composer require 'drupal/admin_toolbar:^3.4'

Composer téléchargera le module Drupal spécifié ainsi que toutes ses dépendances et l’installera dans votre projet.

La version spécifique du module 3.4 peut varier, assurez-vous de consulter la page du module sur Drupal.org pour obtenir les informations les plus récentes.

Pour que Drupal détecte votre nouveau module, vous devrez reconstruire le cache de l’application Drupal en utilisant cette commande :

# Verbose Command : 
$ drush cache:rebuild 
# Alias : 
$ drush cr

Une fois l’installation terminée, vous devrez activer le module. Vous pouvez le faire via l’interface d’administration de Drupal...

Préparation de l'environnement