Un guide simple pour configurer un environnement de développement Drupal local avec DDEV

DDEV + Drupal

Introduction

Si vous débutez dans le développement Drupal ou si vous cherchez à rationaliser votre flux de travail de développement local, DDEV offre un moyen efficace et simple de configurer un environnement Drupal sur votre ordinateur. DDEV, construit sur Docker, simplifie le processus de création d’environnements de développement isolés et cohérents, garantissant que votre configuration locale reflète le plus fidèlement possible votre environnement de production. Ce guide vous guidera à travers les étapes pour démarrer avec Drupal à l’aide de DDEV, couvrant tout, de l’installation et de la configuration au déploiement local de votre site Drupal. À la fin de ce guide, vous disposerez d’un environnement de développement Drupal entièrement fonctionnel, prêt à être utilisé pour apprendre, tester ou créer de nouveaux projets.

Ce que vous apprendrez :

• Comment installer et configurer DDEV pour un projet Drupal
• Comment utiliser l’outil Composer intégré de DDEV pour télécharger Drupal et Drush
• Comment installer Drupal dans DDEV pour pouvoir commencer à créer votre site
• À la fin de ce guide, vous disposerez d’un environnement Drupal local prêt à apprendre ou à travailler sur de nouveaux projets.

But:

Découvrez comment faire fonctionner Drupal sur votre ordinateur local à l’aide de DDEV.

Prérequis :

• Familiarité de base avec l’utilisation d’un terminal de ligne de commande. (Si vous n’êtes pas encore à l’aise avec cela, vous obtiendrez un peu de pratique dans ce guide.)
• Alternatives à Docker : DDEV est basé sur Docker, un outil permettant de créer des environnements isolés sur votre ordinateur. Le moyen le plus simple d’installer Docker consiste à utiliser l’édition Docker Desktop pour votre système d’exploitation. DDEV fonctionne également avec des alternatives Docker comme Colima, spécifiquement destinées aux utilisateurs de macOS et Linux qui souhaitent une alternative à Docker Desktop.
• Pour installer DDEV, suivre le Documentation d’installation du DDEV.
• Une fois installé, courir débogage ddev dans votre terminal pour vérifier l’état et résoudre les problèmes si nécessaire. Référez-vous au Guide de dépannage DDEV pour plus d’informations.

Étape 1: Créer un répertoire et configurer DDEV

Tout d’abord, créez un nouveau dossier sur votre ordinateur dans lequel vous souhaitez stocker votre projet Drupal. Ensuite, accédez à ce dossier à l’aide de votre terminal de ligne de commande.

Par exemple, créons un dossier appelé mon-site et configurez DDEV :

mkdir my-site
cd my-site
ddev config --project-type drupal10 --create-docroot --docroot web

Ces commandes créent un nouveau projet DDEV configuré pour Drupal, stockant tous les fichiers d’installation dans un nouveau .ddev sous-répertoire. Le projet portera le nom de votre dossier (dans ce cas, mon-site).

Note: Vous pouvez modifier la configuration, telle que la version Drupal ou l’emplacement docroot, selon vos besoins.

Étape 2 : Démarrer DDEV

Ensuite, démarrez le conteneur DDEV avec la commande suivante :

ddev start

Cela lancera un serveur Web et un serveur de base de données. DDEV est maintenant prêt à vous aider à installer Drupal à l’aide de Composer, un outil qui gère les dépendances du code de Drupal.

Étape 3: Installer Drupal avec Composer

Maintenant, utilisez Composer dans DDEV pour installer Drupal :

ddev composer create drupal/recommended-project -y

Cette commande télécharge Drupal dans votre dossier actuel. L’utilisation de Composer dans DDEV garantit la cohérence de votre environnement, même si votre version PHP locale diffère de celle de DDEV.

Étape 4: Installer Drupal (à l’aide de Drush)

Vous pouvez maintenant lancer votre site Drupal en exécutant :

ddev launch

Cela ouvrira la page d’installation de Drupal dans votre navigateur Web. Vous avez deux options :

• Utilisez le programme d’installation interactif dans votre navigateur.
• Utilisez Drush, un outil de ligne de commande, pour installer Drupal (recommandé).

Tout d’abord, installez Drush à l’aide de Composer :

ddev composer require --dev drush/drush

Ensuite, utilisez Drush pour installer Drupal :

ddev drush site:install --account-name=admin --account-pass=admin -y

Cette commande installe Drupal et configure un compte administrateur avec le nom d’utilisateur administrateur et le mot de passe administrateur.

Étape 5: Installer les outils de développement

Si vous envisagez de développer du code personnalisé ou de travailler sur des modules contribués, c’est une bonne idée d’installer des outils supplémentaires :

ddev composer require --dev drupal/core-dev

Cette commande installe des outils comme phpcs (pour vérifier les normes du code) et unité php (pour exécuter des tests unitaires).

Commandes DDEV supplémentaires :

Voici quelques commandes DDEV plus utiles :

• ddev import-db –file= »nom de fichier » ou ddev import-db < « nom de fichier »: Importez un fichier de base de données.
• ddev phpmyadmin: Configurez phpMyAdmin pour gérer votre base de données.
• ddev décrire: Obtenez l’URL de votre site.
• arrêt du développement: Arrêtez l’environnement DDEV.
• ddev mysql: Gérer directement la base de données.

Étape 6: Connectez-vous à votre nouveau site Drupal

Enfin, lancez votre nouveau site Drupal en exécutant :

ddev launch

Si vous devez vous connecter en tant qu’utilisateur administrateur, vous pouvez générer un lien de connexion unique avec :

ddev drush uli

A tout moment, vous pouvez courir ddev décrire pour voir l’URL de votre site. Copiez et collez simplement l’URL dans votre navigateur pour le visiter.

ddev drush uli

Conclusion:

Vous disposez désormais d’un site Drupal local opérationnel avec DDEV ! Vous pouvez utiliser cette configuration pour apprendre Drupal ou commencer à travailler sur de nouveaux projets. DDEV facilite la gestion de votre environnement de développement, afin que vous puissiez vous concentrer sur la création de votre site. Bon codage !

VOUS TROUVEZ CELA UTILE ? PARTAGEZ-LE