Drupal-core bijwerken met Composer

Drupal lerenDrupal-woordenlijst

Dit artikel gaat ervan uit dat je Drupal hebt geïnstalleerd met een Composer-project zoals drupal/core-recommended of drupal/dxpr-marketing-cms-project

Beschikbare Drupal-updates weergeven

composer outdated "drupal/*"

Staat er geen regel die begint met drupal/core, dan kent Composer geen update. Is er wel een update, ga dan verder met de commando’s hieronder

Een back-up maken van je Drupal-installatie

Maak bij het bijwerken van een productiewebsite altijd een back-up voordat je bijwerkt, ook als je de update al met succes op een ontwikkel- of testomgeving hebt geprobeerd. Gebruik de hulpmiddelen van je hostingprovider voor een back-up of snapshot van je Drupal-site.

Drupal-corecode bijwerken

als je gebruikt drupal/core-recommended:

composer update "drupal/core-*" --with-all-dependencies

Om de update te simuleren en te tonen wat er zou gebeuren, zonder iets echt te wijzigen, voeg je --dry-run toe.

Bijwerken naar de nieuwste patchversie van de core

Wil je je site bijwerken naar de nieuwste patchversie, maar niet naar de nieuwste kleine versie, voeg dan --with=-opties toe voor elke drupal/core-*-afhankelijkheid in composer.json.

Bijvoorbeeld: als 10.2 de huidige kleine versie is en je je site wilt bijwerken naar de nieuwste patchversie van 10.3:

composer update "drupal/core-*" --with-all-dependencies --with=drupal/core-recommended:~10.3.0 --with=drupal/core-composer-scaffold:~10.3.0

Dit voorbeeld gaat ervan uit dat  drupal/core-recommended en drupal/core-composer-scaffold de enige Drupal-core-afhankelijkheden in composer.json zijn.

Bijwerken naar een specifieke versie van de core

Over het algemeen raden we aan om bij het bijwerken geen specifieke versie van Drupal-core op te geven, tenzij je weet dat je op een specifieke versie wilt vastpinnen. Wil je je site toch op een specifieke versie vastpinnen, gebruik dan het volgende voorbeeld: 

Om je site op versie 10.3.6 vast te pinnen en alle afhankelijkheden dienovereenkomstig bij te werken: 

composer require drupal/core-recommended:10.3.6 drupal/core-composer-scaffold:10.3.6 drupal/core-project-message:10.3.6 --update-with-all-dependencies

Waarschuwing: als je je site op een specifieke coreversie vastpint, komt die versie in het lockbestand en gaan toekomstige updates niet verder dan deze versie. Draai het require-commando zoals hieronder opnieuw om terug te keren naar een ‘niet-vastgepinde’ versie van de core.

Losmaken van een specifieke versie van de core

Draai je een vastgepinde versie van Drupal-core en wil je je site naar een andere versie bijwerken, dan heb je twee keuzes.

  1. Je draait het composer require-commando hierboven om een nieuwe, vastgepinde versie van de core op te geven. 
  2. Je maakt je coreversie los en werkt bij naar de nieuwste versie van Drupal.

Om je Drupal-versie los te maken, draai je dit commando: 

composer require drupal/core-recommended drupal/core-composer-scaffold drupal/core-project-message --update-with-all-dependencies

Database-updates draaien

Voor het gemak hebben we de Drush-commando’s opgenomen die nodig zijn om een update te voltooien; veel mensen vinden Drush sneller en eenvoudiger dan het webgebaseerde beheergebied.

Je kunt drush gebruiken:

drush updatedb
2|drush cache:rebuild

Of je bezoekt [YOUR DOMAIN]/update.php in een browser.