README

This project extends the standard DDEV setup with additional functionality and tools specifically designed for Drupal development. It provides a set of custom commands, configurations, and automation scripts to enhance your Drupal development workflow.

Features

Custom DDEV Commands

pmu: Runs drush pmu commands and creates dummy module folders if they don't exist. This helps to uninstall module that has gone missing for example during branch switching.
```
ddev pmu module1 module2 ...
```
grumphp: Runs GrumPHP commands
```
ddev grumphp
```
phpunit: Runs PHPUnit commands
```
ddev phpunit
```
regenerate-phpunit-config: Regenerates fresh PHPUnit configuration
```
ddev regenerate-phpunit-config
```
syncdb: Synchronizes local database with production. For this you should have set prod alias in drush/sites/self.site.yml
```
ddev syncdb
```
yq: Runs yq commands (YAML processor) It's available inside DDEV, but we expose it to host because why not :). It's required in syncdb script, but it could prove useful in day to day work.
```
ddev yq
```

Enhanced Configuration

Custom DDEV Configuration
- Post-start scripts for both host and web containers - by default it gives you uli link.
- Automatic update checks for this package
Performance Optimizations
- Special database_dumps/ directory for Mac users not to mount db dumps

Automated Workflows

The project includes several automated workflows:

Database Management
- Post-import database hooks (clears cache, sanitizes database)
- Post-restore snapshot hooks (clears cache, sanitizes database)
- Database synchronization from production
Development Environment Setup
- Automatic composer installation on first start
- Post-start hook that run drush uli
- Integration with Wunderio's development tools eg grumphp, phpunit

Both custom commands and hooks are scripts under dist/.ddev/wunderio/core/ folder and you can extend them if you copy particular script to dist/.ddev/wunderio/custom/. This folder is never overwritten during autoupdate.

Requirements

DDEV

Installation

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
```
Install wunderio/ddev-drupal Composer package with DDEV and restart DDEV:
```
ddev composer require wunderio/ddev-drupal --dev && ddev restart
```
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.

Import database:

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

or install site:

ddev drush si

Create admin link and login:
```
ddev drush uli
```

Performance Optimization

Database Operations for Mac Users

Important for Mac users: When working with database imports and exports on macOS, you should store your database dump files in the database_dumps directory at the project root. This directory is specially configured in this template to provide specific performance benefits.

project-root/
├── database_dumps/    <- Place your .sql or .sql.gz files here
├── web/
├── .ddev/
└── ...

Key benefits:

Faster DDEV startup times: When large database files are stored in the standard project directories, they can significantly slow down DDEV startup as Mutagen indexes and syncs these files. Using the database_dumps directory avoids this overhead.
Reduced virtual disk usage: By excluding database dumps from Mutagen synchronization, your virtual disk requires less space, preventing potential disk space issues.

This optimization is configured via upload_dirs in .ddev/config.wunderio.yaml:

upload_dirs:
  - ../database_dumps

Example usage:

# Save your database dumps to the database_dumps directory
cp ~/Downloads/my-database-backup.sql.gz ./database_dumps/

# Then import using the path relative to your project
ddev import-db --file=database_dumps/my-database-backup.sql.gz

This improvement is particularly noticeable in projects with multiple or large database dumps, where startup times can be reduced from minutes to seconds.

Note for Linux users: While this configuration doesn't provide performance improvements on Linux systems (which don't use Mutagen), it's still good practice to store database dumps in the dedicated database_dumps folder for consistent organization across team environments.

wunderio / ddev-drupal

Maintainers

Details