wunderio/ddev-drupal

Wunder's extendable template for DDEV Drupal projects.

0.4.0 2024-10-29 08:54 UTC

Requires

• composer-plugin-api: ^2.0
• drupal/core: ^8 || ^9 || ^10 || ^11

Requires (Dev)

• composer/composer: ^2.0

GPL-2.0-or-later

• Hannes Kirsman

README

This is a template for DDEV Drupal projects for defining the base DDEV setup for Drupal. It comes with predefined .ddev/config.wunderio.yaml file and .ddev/dist folder which contents is copied to your project root.

Installation

1. Initialize your Drupal 10 project. Project name parameter is optional, but it's advisable to use domain name as your project name as that's used for for the subdomain of ddev.site eg if project name is example.com, then localhost URL will become example.com.ddev.site.

   ddev config --project-type=drupal10 --docroot=web --project-name=example.com

2. Install wunderio/ddev-drupal Composer package with DDEV and restart DDEV:

   ddev composer require wunderio/ddev-drupal --dev && ddev restart

3. Add changes to GIT (note that below command uses -p, so you need to say 'y'es or 'n'o if it asks what to commit):

   git add .ddev/ &&
   git add drush/sites/ &&
   git add composer.lock &&
   git add -p composer.json web/sites/default/settings.php grumphp.yml &&
   git commit

   Also note that whenever you update wunderio/ddev-drupal package, you need to add everything under .ddev to GIT.

4. Import database:

   ddev import-db --file=some-sql-or-sql.gz.file.sql.gz

   or install site:

   ddev drush si

5. Create admin link and login:

   ddev drush uli