Drupal Core handmatig bijwerken

Voordat je begint

Als je dat nog niet hebt gedaan, wordt aanbevolen om eerst deze inleiding te lezen, waarin kort alle opties worden samengevat die je kunt kiezen bij het updaten van Drupal 8.

PS! Deze updateprocedure wordt ook beschreven in de gebruikershandleiding.

Als je extra modules hebt geïnstalleerd met externe afhankelijkheden via Composer, moet je een andere update­methode gebruiken, aangezien deze instructies de map vendor/ zullen overschrijven.

Drupal 8 Core handmatig bijwerken

Stappen om Drupal 8 Core handmatig bij te werken via de command line (shell):

1. Maak een back-up van je bestanden en database. Een volledige back-up maakt het eenvoudig om terug te keren naar de vorige versie als de update mislukt.

Indien gewenst, als je handmatige wijzigingen hebt aangebracht in bestanden zoals .htaccess, composer.json of robots.txt, kopieer deze dan naar een veilige locatie. Nadat je het nieuwe Drupal-core hebt geïnstalleerd, moet je deze wijzigingen opnieuw toepassen. Bijvoorbeeld, Acquia Dev Desktop plaatst het .htaccess-bestand in de hoofdmap — zonder dit bestand werkt alleen de startpagina van je site.

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

2. Log in op Drupal met een gebruiker die de machtiging “Beheer van software-updates” heeft.

3. Zet je site in onderhoudsmodus via het Drupal-beheer:

   - Ga naar Beheer > Configuratie > Ontwikkeling > Onderhoudsmodus.
   - Vink “Put site into maintenance mode” aan.
   - Klik op “Save configuration”.

4. Kies een van de volgende twee methoden om bestanden te verwijderen uit de hoofdmap, evenals de mappen core en vendor, maar laat de mappen modules, profiles, sites en themes staan:

Via de command line (shell)

cd /path/to/your/drupal/directory
rm -rf core vendor
rm -f *.* .[a-z]*

Via een FTP-client

1. Ga naar de Drupal-map.
2. Selecteer alle bestanden in de hoofdmap (ook verborgen bestanden die met een punt beginnen) en verwijder deze samen met de mappen core en vendor. Verwijder niet de mappen modules, profiles, sites en themes.

5. Soms bevat een update wijzigingen in het bestand default.settings.php. Dit wordt vermeld in de release notes. Je kunt de release notes voor jouw versie vinden op https://www.drupal.org/project/drupal. Onderaan de projectpagina, onder “Downloads”, klik je op de link voor jouw versie van Drupal om de release notes te bekijken. Als jouw versie niet in de lijst staat, gebruik dan “View all releases”.

• Kopieer aangepaste regels uit je back-up naar het nieuwe bestand settings.php, vooral de databaseverbinding en andere specifieke instellingen.
• Maak een kopie van het nieuwe default.settings.php-bestand en hernoem het naar settings.php (en overschrijf het oude bestand).
• Maak een back-up van het nieuwe settings.php-bestand onder een andere naam.
• Het bestand settings.php bevindt zich meestal in /sites/default/.

6. Kies een van de volgende twee methoden om de nieuwe bestanden van Drupal te plaatsen in de hoofdmap en de mappen core en vendor:

Via de command line

wget https://ftp.drupal.org/files/projects/drupal-x.y.z.tar.gz
tar zxf drupal-x.y.z.tar.gz
cd drupal-x.y.z
cp -R core vendor /path/to/your/drupal/directory
cp *.* .[a-z]* /path/to/your/drupal/directory

Via browser en FTP-client

• Download de nieuwste Drupal 8.x.x-versie van https://www.drupal.org/download.
• Pak het archief uit buiten je webroot.
• Gebruik een FTP-client om de mappen core en vendor en de bestanden uit de hoofdmap naar je Drupal-installatie te uploaden.

7. Pas eventueel handmatig wijzigingen opnieuw toe op bestanden zoals .htaccess, composer.json of robots.txt.

8. Voer update.php uit in je browser door te gaan naar http://www.example.com/update.php (vervang www.example.com door jouw domein). Dit zal de database bijwerken.

Als je geen toegang hebt tot update.php (omdat je niet bent ingelogd met een gebruiker met de juiste rechten of de oorspronkelijke beheerdersaccount), kun je tijdelijk deze beperking opheffen:

$settings['update_free_access'] = FALSE;

Wijzig dit tijdelijk in:

$settings['update_free_access'] = TRUE;

Bezoek daarna opnieuw /update.php. Zodra de update is voltooid, wijzig dit terug naar FALSE voor beveiliging.

9. Log in als beheerder in Drupal en ga naar Beheer > Rapporten > Statusrapport om te controleren of alles goed werkt.

10. Zet je site weer online via Beheer > Configuratie > Ontwikkeling > Onderhoudsmodus en verwijder het vinkje bij “Put site into maintenance mode”. Klik op “Save”.

11. Verwijder de gedownloade en uitgepakte versie van Drupal:

rm drupal-x.y.z.tar.gz
rm -rf drupal-x.y.z/

12. Klaar! Je hebt Drupal 8 Core succesvol handmatig bijgewerkt via de command line of browser. :)