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 install
will 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