Drupal Getting Started Guide¶
This tutorial gives an example of the DDEV-Live commands specific to Drupal. First you will need to set up your DDEV-Live account and connect to your GitHub acccount using the Getting Started Guide. DDEV-Live supports other PHP applications and CMSs such as TYPO3, WordPress.
DDEV-Live default settings for Drupal¶
We give additional flags below to use if your project differs from these defaults.
- Default Drupal version is Drupal 8.
- Default docroot is the project root (ie the directory from which your site is served).
- Default branch is master.
composer installwill not run.- Default php version is 7.2.
Add a Drupal site from your connected GitHub account¶
To create a site named mysite on DDEV-Live and import code from a connected GitHub account named ddev-demo with a repo named mysite using the default settings, run:
$ ddev-live create site drupal mysite --git-repo https://github.com/ddev-demo/mysite
Use ddev-live describe site mysite to view info about your site.
Drupal-specific flags¶
You can add flags for specific configuration options. Use ddev-live create site drupal --help to see all possible flags and their descriptions.
| Flag | Description |
|---|---|
--drupal-version <version> |
Specify the Drupal version, <7>, <8>, or <9>. The default is Drupal 8. |
--docroot <path> |
The docroot is the directory from which your site is served. The default is the project root, --docroot "". This value is a relative path from your project root. For Drupal 8, the most common is --docroot web. |
For Drupal 9
If you're running Drupal 9, don't forget you need to pass --php-version=7.3
Here is an example for a Drupal 9 site specifying the Drupal version, php version, docroot and running composer install:
$ ddev-live create site drupal ddev-demo/mysite --git-repo https://github.com/ddev-demo/mysite --php-version=7.3 --drupal-version=9 --docroot web --run-composer-install
Here is an example for a Drupal 8 site that requires composer install, with the docroot in /web:
$ ddev-live create site drupal ddev-demo/mysite --git-repo https://github.com/ddev-demo/mysite --docroot web --run-composer-install