/drupal9-contrib

Drupal 9 core contribution installation powered by Docksal

Primary LanguagePHP

Docksal-powered Drupal 9 Core Contribution Installation

This is a Drupal 9 (and 10) installation geared for local Core and Contrib development for use with Docksal.

Build status

Features:

Setup instructions

Step #1: Docksal environment setup

This is a one time setup - skip this if you already have a working Docksal environment.

Follow Docksal environment setup instructions

Step #2: Project setup

  1. Clone this repo into your Projects directory

    git clone https://github.com/docksal/drupal9-contrib.git drupal9
    cd drupal9
    
  2. Initialize the site

    This will clone the core repository into docroot, initialize local settings and install the site via drush

    fin init
    
  3. Point your browser to

    http://drupal9.docksal
    

When the automated install is complete the command line output will display the admin username and password.

Step #3: Contributing to core!

  1. Find and issue, and create a local branch in the docroot folder:

    cd docroot
    git checkout -b 12345-short-description
    

    where 12345 is the issue number, and short-description is just something to remind you of the issue.

  2. Apply the patch from the issue if it exists.

  3. Run any relevant phpunit tests locally:

    fin phpunit path/to/file/or/directory
    

    for instance:

    fin phpunit core/tests/Drupal/Tests/Component/Utility/UnicodeTest.php
    

    Note: it is not advisable to simply run fin phpunit as this will run all the core tests, which can take hours locally.

Security notice

This repo is intended for local core contributions and includes a hardcoded value for hash_salt in settings.php. You should not base your project off of this code base. If you do for whatever reason, make sure you regenerate and update the hash_salt value. A new value can be generated with drush ev '$hash = Drupal\Component\Utility\Crypt::randomBytesBase64(55); print $hash . "\n";'