weknowinc/drupal-project

Project template for Drupal 8 projects with composer. Optimized to use with Docker and DrupalConsole.

dev-master 2018-03-12 08:04 UTC

Requires

• composer/installers: ^1.2
• cweagans/composer-patches: ^1.6
• drupal-composer/drupal-scaffold: ^2.2
• drupal/console: ^1.0.2
• drupal/core: ~8.5
• drush/drush: ^9.0.0
• webflo/drupal-finder: ^1.0.0
• webmozart/path-util: ^2.3

Requires (Dev)

• webflo/drupal-core-require-dev: ~8.5

Conflicts

• drupal/drupal: *

GPL-2.0-or-later

README

Optimized to use with Docker and DrupalConsole.

Clone repository

git clone https://github.com/weknowinc/drupal-project

Copy and rename the .env.dist file

cp .env.dist .env

Edit configuration

Edit the copied .env file and make changes according to your project needs.

Example update default HOST_NAME from drupal.develop to mysite.develop.

Starting the containers

To start the containers you need to execute the following command docker-compose up -d, grab some coffee or a beer and be patient while the images are downloaded to your local computer.

docker-compose up -d

NOTE: We suggest provide the detached mode flag to run in background.

Add hostname entry in your /etc/hosts file

127.0.0.1    drupal.develop

NOTE: Use your own domain if you make changes in the copied .env file.

Open your browser and point to http://drupal.develop/ or the hostname you entered on the .env file.

Shutting down the containers

docker-compose down

docker-compose down -v

NOTE: You can pass the -v flag to destroy the shared volumes as well. Be careful this will destroy any data on the shared volumes between the container and the local machine.

Checking for used ports

One common issue you'll likely run into while starting the containers, is finding the ports in use, this could mean an instance of Apache, Nginx, MySQL or other service is already running, so if you want to know what is using the ports you can run this commands on your terminal:

# web (Apache, Nginx)
lsof -i :80

# db (MySQL, MariaDB)
lsof -i :3306

We based the docker configuration of this repository on the Drupal4Docker project.

We based the composer configuration on the drupal-composer/drupal-project project.

Click here for info about composer.