Docker4Drupal

This is "Bitoid" Docker4Drupal installation instructions i have used for my project:

Docker4Drupal is an open-source project GitHub page that provides pre-configured docker-compose.yml file with images to spin up local environment on Linux, Mac OS X and Windows.

Requirements

• Install PHP

sudo apt install php-cli php-curl php-gd php-mbstring php-sqlite3 php-xml

• Install Docker ubuntu.

• To run docker without sudo enter in terminal:

https://docs.docker.com/engine/install/linux-postinstall/

Restart PC

Installation

1. Make direction file for your project.

mkdir drupal-project

2. Create composer project:

composer create-project drupal-composer/drupal-project:9.x-dev drupal-project --no-interaction

3. Download and unpack docker4drupal.tar.gz from the latest stable release to your project root.

• Go to project root.

cd drupal-project

• Unpack docker4drupal.tar.gz

4. Delete docker-compose.override.yml.

5. Create configuration file.

mkdir config/sync -p

6. User permisions for container.

chown -R 1000:1000 ./

7. Set up Mariadb volume by uncomment 13 and 15 lines and changing path in docker-compose.yml to prevent erasing database after docker compose down.

volumes:
#      - ./mariadb-init:/docker-entrypoint-initdb.d # Place init .sql file(s) here.
      - ./mariadb-data:/var/lib/mysql # Use bind mount

Note: 8 and 9 steps are optional, if you have no idea what they do, you can just skip this steps.

8. optional: Database acceess settings in your .env file:

MYSQL_DATABASE=${DB_NAME}
MYSQL_HOSTNAME=${DB_HOST}
MYSQL_PASSWORD=${DB_PASSWORD}
MYSQL_PORT=${DB_PORT}
MYSQL_USER=${DB_USER}

9. optional: A common use case is to supply database credentials via the environment. Add to settings.php:

$databases['default']['default'] = [
   'database' => $_ENV['MYSQL_DATABASE'],
   'driver' => 'mysql',
   'host' => $_ENV['MYSQL_HOSTNAME'],
   'namespace' => 'Drupal\\Core\\Database\\Driver\\mysql',
   'password' => $_ENV['MYSQL_PASSWORD'],
   'port' => $_ENV['MYSQL_PORT'],
   'prefix' => '',
   'username' => $_ENV['MYSQL_USER'],
 ];

Congrats you can now run Drupal!

• Run in terminal:

docker compose up -d

• Open browser and go to this adress:

http://drupal.docker.localhost:8000/

---

https://www.linkedin.com/in/otarza/

Configure Your Environment for Drupal Development.

Enable developer/debug mode.

Uncommenting the following lines in the settings.php file. Make sure this code is at the bottom of your settings.php file so that local settings can override default settings.

if (file_exists(__DIR__ . '/settings.local.php')) {
  include __DIR__ . '/settings.local.php';
}

and then copying the file example.settings.local.php from /sites folder to /sites/default folder and rename it to settings.local.php

cp sites/example.settings.local.php sites/default/settings.local.php

It adds a few settings which will help you in debugging and making development easier. If you don't want any of them in particular, you can always comment them out. Note : If you think adding a file_exists call to each page will slow down the site, you can always remove it in the production code.

Disable render caching and JavaScript/CSS aggregation

• Uncomment lines in settings.local.php

1. Ensure that the following lines are uncommented by removing the # character from the beginning of the line.

This first set disables the CSS and JavaScript aggregation features.

$config['system.performance']['css']['preprocess'] = FALSE;
$config['system.performance']['js']['preprocess'] = FALSE;

2. And uncommenting this line effectively disables, or rather, bypasses the Render API cache:

$settings['cache']['bins']['render'] = 'cache.backend.null';

3. You can also disable the Dynamic Page Cache by uncommenting this line:

$settings['cache']['bins']['dynamic_page_cache'] = 'cache.backend.null';

Enable Twig debugging options

• Edit the following variables under the twig.config: section.

If you're placing this into your sites/development.services.yml file, add the twig.config configuration indented under the parameters: line. Ensure that your code additions are appropriately indented with 2 spaces, not the tab character (or an error will result).

parameters:
  twig.config:
    debug: true
    auto_reload: true
    cache: false

4. Install Webprofiler and Identify Controllers Confugure: Check the boxes for: Events, Routing and Services. Save Configuration.

---

Installing themes or plugins

docker compose exec php composer require 'drupal/<theme or plugin name>'