Use this project as a template for working on Drupal core and contrib modules.
Most of the dev tools are in the php Docker container, but you will need one or two out side of that.
- PHP 7.1+
- and Composer.
If you don't have these installed, then follow the instructions for your specific platform.
Download and install Homebrew follow the online instructions.
Add the php tap:
brew tap homebrew/homebrew-php brew install git composer php71 php71-mcrypt php71-xdebug
To create a new project in a directory called `myproject' run the following command.
composer create-project --no-install -s dev previousnext/drupal-project myproject
You will need to install Docker and related tools.
Download and install Docker for Mac
Download and install Docker for Windows
Download and install Make for Windows
You know what you're doing, right?
Due to networking, and file system performance issues in Docker for Mac, you
need a slightly different docker-compose.yml file for MacOS. To simplify your
commands, we recommend creating an alias in
~/.bashrc such as:
alias dc='docker-compose -f docker-compose.osx.yml'
To start the container, run:
dc up -d
Setup and Install Drupal
For simplicity, run all commands from within the php container. You can get shell access via:
dc exec app bash
To initialise your local dev environment run the following:
To set up common developer options, run:
Install a contrib module
The easiest way to install a contrib module to work on is via composer.
For example, to work on pathauto, type the following:
composer require drupal/pathauto --prefer-source
To run tests, run: