Zie jij door de bomen het bos niet meer? Hier zijn 6 Drupal best practises.

Drupal Console is een krachtige Command Line Interface. Het wordt gebruikt om boilerplate code te genereren en Drupal te onderhouden en te debuggen. 

Om Drupal Console aan een  project toe te voegen, hoef je  maar één commando te gebruiken. Dit commando luidt als volgt:

composer require drupal/console:~1.0 \
--prefer-dist \
--optimize-autoloader

Daarna kunnen we binnen Drupal Console verschillende commando's gebruiken. We geven hieronder enkele voorbeelden.

Module generatie:

drupal generate:module \
  --module="modulename" \
  --machine-name="modulename" \
  --module-path="/modules/custom" \
  --description="Mijn geweldige module" \
  --core="9.x" \
  --package="Custom" \
  --module-file \
  --composer \
  --test \
  --twigtemplate

Het genereren van een entity:

drupal generate:entity:content \
  --module="modulename" \
  --entity-class="DefaultEntity" \
  --entity-name="default_entity" \
  --base-path="/admin/structure" \
  --label="Standaard entiteit" \
  --is-vertaalbaar \
  --reviseerbaar \
  --has-forms

Het genereren van een service:

drupal generate:service \
  --module="modulename" \
  --name="modulename.default" \
  --class="DefaultService" \
  --interface \
  --interface-name="InterfaceName" \
  --path-service="/modules/custom/modulename/src/".

Het aanmaken van een gebruiker:

drupal user:create gebruikersnaam wachtwoord \
  --roles='geauthenticeerd' \
  --email="username@testing.com"  \
  -status="1"

Zoals je ziet, geeft Drupal Console ons veel mogelijkheden. Een andere interessante optie die deze Command Line Interface (CLI) ons biedt, is het draaien van een lokale PHP-server om onze website te testen. Dit kan door middel van de volgende command:

$ drupal server

Dit commando start voor ons een lokale server op poort 8088

Het Examples for Developers project is een grote verzameling voorbeelden van hoe je eigen modules in Drupal kunt schrijven. Deze module biedt  33 verschillende modules, van eenvoudige blokken, via verschillende soorten formulieren, tot controllers met REST API ondersteuning. Je zult waarschijnlijk alle voorbeelden vinden die je nodig hebt om zelf modules te kunnen bouwen. Deze module zal je helpen om nieuwe dingen leren en sneller werken.

De Devel module bevat extra functies en hulppagina's voor ontwikkelaars en beheerders. Deze voorziet jou als ontwikkelaar van blokken en werkbalken voor snelle toegang en informatie. We kunnen deze gebruiken om een andere gebruiker te "simuleren". Dit is een zeer nuttige functionaliteit, vooral bij het testen van  rollen en rechten in Drupal. Devel biedt ons functies die ons helpen bij het debuggen. En de kers op de taart - we kunnen het gebruiken om testinhoud te genereren.

Met behulp van composer kun je deze module gemakkelijk installeren aan de hand van de volgende command: 
composer require --dev drupal/devel

Soms gebeurt het in ons project dat we modules gebruiken die dezelfde hooks gebruiken. In de standaard configuratie staat Drupal niet toe om de volgorde van module-uitvoering te kiezen. Deze volgorde kan worden aangepast door de modules een verschillend ‘gewicht’ te geven.  Dit kan op drie manieren worden gerealiseerd.

In het installatiebestand van onze module kunnen we HOOK_install toevoegen en daarmee het modulegewicht instellen.

Drupal 9 biedt een ingebouwde functie om dit probleem op te lossen:

function your_module_name_install() {
  module_set_weight('[your_module_name]', [your_preferred_weight]);
}

In Drupal 7 is het iets ingewikkelder, omdat we dit veld in de database zelf moeten veranderen:

function your_module_name_install() {
db_update('system')
    ->fields(array('weight' => your_preferred_weight))
    ->condition('name', '[your_module_name]', '=')
    ->execute();
}

Als we configuraties gebruiken in ons project, kunnen we het gewicht van onze module wijzigen in het bestand core.extension.yml nadat we ze geëxporteerd hebben. Het gewicht wordt weergegeven als een getal achter de naam van de module. Hoe groter het gewicht, hoe eerder de methoden in de module worden uitgevoerd.

De Drupal module Modules Weight voegt een gebruiksvriendelijke configuratie van modulegewichten toe. As je naar de configuratiepagina navigeert (/admin/config/system/modules-weight/configuration),

 kun je eenvoudig de gewichten van onze modules instellen.

Dit is een tool die de lokale ontwikkeling van onze website vergemakkelijkt. Het stelt ons in staat om letterlijk alles te runnen en is gebaseerd op Docker. We hebben nu de CLI (Command Line Interface)  tot onze beschikking, waarmee we eenvoudig onze installaties kunnen beheren. Om lokaal een Drupal-installatie op te zetten, hebben we slechts enkele commando's nodig. Allereerst maken we een Drupal-project aan met Composer. Dit doen we aan de hand van de volgende command:
composer create-project drupal/aanbevolen-project lando-demo

Dan navigeren we naar de aangemaakte directory en voeren het volgende commando uit:
lando init

Vervolgens kun je de volgende stappen doorlopen: 

• Kies drupal9 als recept,
• noem je webroot web,
• en geef vervolgens je project een naam.

Na dit proces wordt een .lando.yml bestand aangemaakt. Je  zal daar een heleboel verschillende informatie vinden, zoals de naam van je project, welke diensten je bebruikt (in eerste instantie zullen dit appserver en database zijn), adressen van de applicatie, de PHP versie, of toegangsgegevens voor onze database.
Vervolgens kun je de volgende command runnen:
lando start

Nu kun je naar  het in .lando.yml opgegeven adres navigeren en de Drupal-installatie verder blijven ontwikkelen.

Last but not least, noemen we Drush. Dit is zonder twijfel dé tool die elke Drupal developer zou moeten kennen. Drush bestaat al sinds Drupal 4.7 en wordt nog steeds telkens up to date gehouden. Op het moment van schrijven is de laatste versie 11.1.1, uitgebracht op 12 juli 2022. Met behulp van Drush kun je  websites beheren door configuraties te importeren en exporteren, de database bij te werken of de cache op te schonen. Met nieuwere versies van deze tool kunnen we ook code genereren. Laten we enkele nuttige commando's overlopen:

Cache opschonen

• drush cr

Configuratie importeren

• drush cim

Configuratie exporteren

• drush cex

Aanmaken van een eenmalige login link

• drush uli

Module inschakelen

• drush en module_name

Module uitschakelen en verwijderen

• drush pmu module_naam

Database bijwerken

• drush updb

Watchdog controleren (dblog module)

• drush ws

Wat betreft het genereren van code hebben we veel opties om uit te kiezen. We raden aan het commando

• drush genererate

Vervolgens kun je op zoek gaan naar de optie die jij op dat moment heet meest passend/nodig acht.