Drupal Core bijwerken via Drush

Deze documentatie is verouderd. Help deze bij te werken.

Voordat je begint

Het wordt aanbevolen om Composer te gebruiken voor het beheren van Drupal-afhankelijkheden. Lees Composer gebruiken met Drupal voor meer informatie. Drush 9 ondersteunt geen core-updates meer en laat dit over aan Composer. Daarom is het aanbevolen om Composer te gebruiken om Drupal bij te werken. Als je echter al lange tijd Drush gebruikt, kun je nog steeds Drush 8 (8.14 of nieuwer) gebruiken om Drupal 8 bij te werken.

P.S.: In de introductie van deze handleiding worden alle update-opties samengevat waaruit je kunt kiezen.

Ga altijd terug naar je back-up als je tijdens het updateproces een fatale fout krijgt.

Drupal 8 Core bijwerken

Stappen om Drupal 8 Core bij te werken met Drush 8.x. Drush is de Drupal-shell.

1. Maak een back-up van je bestanden en database. Met Drush voer je het volgende commando uit:

drush archive-dump

Opmerkingen:

• Het is belangrijk om back-ups te maken vóór het updaten. Zo kun je snel terugkeren als er iets misgaat tijdens of na het updateproces.
• Het commando drush archive-dump maakt een .tar.gz-bestand met je bestanden en database. Dit commando is verouderd en wordt in de toekomst verwijderd uit Drush. Het dekt alleen bestanden in de map /web.

2. Controleer op beschikbare updates

drush pm-updatestatus

• Alias: ups
• Opmerking: dit commando wordt niet aanbevolen voor Composer-gebaseerde installaties. Gebruik in plaats daarvan composer show.

3. Activeer de onderhoudsmodus

drush state-set system.maintenance_mode 1

Alias: sset

4. Wis de cache

drush cache-rebuild

• Alias: cr
• Dit commando leegt de cache_*-tabellen in de database en herbouwt de servicecontainer van de site.

5. Kies één of meer van de onderstaande opties om updates uit te voeren. Welke optie je kiest hangt af van het type update dat nodig is. pm-update (alias: up) werkt de code bij en voert eventuele database-updates uit, vergelijkbaar met pm-updatecode + updatedb.

Optie: Drupal 8 Core bijwerken

drush pm-update drupal

Optie: Drupal 8 Core bijwerken naar de ontwikkelbranch (alleen voor testen, niet voor productie)

drush pm-update drupal-8.5.x-dev

Optie: Eén module bijwerken

drush pm-update module_name

Optie: Alleen beveiligingsupdates uitvoeren

drush pm-update --security-only

6. Pas indien nodig handmatig wijzigingen opnieuw toe aan bestanden zoals .htaccess, composer.json of robots.txt. Drush doet dit niet automatisch.

7. Herstel eventuele core-patches die je eerder hebt toegepast (mits deze nog niet in de core zijn opgenomen).

Gebruik git log om eerdere patches terug te vinden:

% git log --oneline --reverse core
ee2bf8dd Issue #18: Updated Drupal core from 8.3.4 to 8.3.5.
267e3ad0 Issue #27: Applied patch from https://www.drupal.org/project/drupal/issues/2174633#comment-12291691.
718ecba5 Issue #9: Applied patch from https://www.drupal.org/project/drupal/issues/2906229#comment-12496488.

Voor elke eerder toegepaste patch gebruik je git cherry-pick in chronologische volgorde:

% git cherry-pick 267e3ad0
% git cherry-pick 718ecba5

8. Als je Composer gebruikt om PHP-bibliotheken te beheren (bijvoorbeeld voor bepaalde contrib-modules), update dan de map /vendor met het volgende commando:

composer update drupal/core --with-dependencies

9. Voer database-updates uit indien vereist:

drush updatedb

Alias: updb

10. Controleer of je site goed werkt:

• Bekijk het statusrapport in Drupal op fouten of waarschuwingen.
• Test de belangrijkste pagina’s van je site in een browser.

11. Schakel de onderhoudsmodus uit

drush state-set system.maintenance_mode 0

12. Wis opnieuw de cache

drush cache-rebuild

13. Klaar! Je hebt Drupal 8 succesvol bijgewerkt met Drush :)