1.2.1. Mise à jour des modules et du noyau de Drupal 8.
Très souvent, des mises à jour sont publiées pour les modules et le noyau de Drupal 8. Il n’est pas nécessaire d’installer toutes les mises à jour, mais il est important de prêter attention aux mises à jour de sécurité. Drupal signale ces mises à jour critiques en rouge. La méthode de mise à jour dépend de la façon dont vous avez installé Drupal : si vous avez utilisé Composer pour créer le projet, vous pouvez alors utiliser Composer pour mettre à jour Drupal. Si vous avez téléchargé Drupal depuis drupal.org, vous devrez le mettre à jour manuellement.
Mise à jour de Drupal avec Composer
Mettre à jour Drupal avec Composer est une tâche routinière, réalisée avec une seule commande :
composer update drupal/core --with-dependencies
Il est important de mettre à jour avec l’option --with-dependencies afin que tous les paquets requis par Drupal soient aussi mis à jour. Ensuite, il faudra exécuter le fichier update.php ou utiliser drush updatedb ou drupal update:execute.
Mise à jour de Drupal manuellement sans Composer ni Drush
Vous pouvez également consulter cet article sur la mise à jour manuelle de Drupal :
https://drupalbook.org/ru/drupal/122-obnovlenie-drupal-8-bez-drush-i-bez-composer
Vous pouvez aussi consulter la documentation officielle sur la mise à jour de Drupal 8 :
https://www.drupal.org/node/1494290
Mais ce qui m’inquiète, c’est qu’ils recommandent de supprimer tous les fichiers de l’ancienne version de Drupal. Pourtant, certains fichiers tiers peuvent s’y trouver, comme ceux nécessaires à Drupal Commerce.
1. Avant toute mise à jour de Drupal ou des modules, effectuez une copie complète du site et de la base de données.
Vous pouvez copier la base via Adminer. Voici un article à ce sujet :
https://drupalbook.org/ru/drupal/15-vybor-hostinga-pokupka-domennogo-imeni-perenos-sayta-na-hosting
2. Téléchargez la dernière version du module ou du noyau Drupal pour la branche 8.x.
3. Décompressez le module ou Drupal en dehors du site. Vérifiez le dossier vendor – certains fichiers pourraient y manquer et devront être copiés manuellement. De nouvelles bibliothèques peuvent avoir été ajoutées dans la nouvelle version. Par exemple, lors de l’installation de Drupal Commerce, j’avais des bibliothèques supplémentaires :
Vérifiez deux fois que vous avez une copie du site avant de continuer.
Je ne suis pas sûr que tout se passera bien si vous écrasez simplement les fichiers. Lorsque j’ai essayé de mettre à jour d’une version bêta à une autre, le site a planté. Mais quand j’ai fait la mise à jour de 8.0.1 à 8.0.5, tout s’est bien passé. Cependant, cela ne fonctionne probablement pas pour un passage à 8.1.0.
4. Activez le mode maintenance pour empêcher les visiteurs d’accéder au site et éviter des erreurs pendant la mise à jour :
/admin/config/development/maintenance
N’oubliez pas de désactiver ce mode après la mise à jour.
5. Supprimez maintenant tous les fichiers Drupal sauf les dossiers /sites, /themes/ et /modules. Le dossier sites contient vos fichiers de contenu : images, configurations, fichiers générés. Le dossier themes contient vos thèmes personnalisés, et modules contient vos modules supplémentaires. Avant de supprimer quoi que ce soit, assurez-vous une troisième fois d’avoir une sauvegarde complète. Pendant la suppression, le site ne fonctionnera plus jusqu’à ce que les nouveaux fichiers Drupal soient copiés. Drupal contient environ 10 000 fichiers, donc si vous avez une connexion lente et que vous transférez par FTP, cela peut prendre plus d’une heure. Prenez donc vos précautions. Je décris ici un cas général, pour un site en production. Sur un serveur local (OpenServer), c’est plus simple.
6. Copiez maintenant tous les fichiers de la nouvelle version de Drupal vers le serveur, sauf les dossiers /sites, /themes/, /modules. Apprenez à utiliser SSH et la ligne de commande (si votre hébergeur le permet – vérifiez vos accès ou demandez au support technique). Avec la ligne de commande, vous pouvez rapidement décompresser tout Drupal après avoir téléversé l’archive :
Pour une archive tar.gz :
tar -xvzf archive.tar.gz
Ou pour une archive zip :
unzip archive.zip
Si vous avez accès SSH, vous pouvez aussi utiliser WinSCP :
https://winscp.net/eng/docs/lang:ru
Vous pouvez aussi utiliser ses commandes personnalisées de décompression :
https://winscp.net/eng/docs/custom_commands
Ou bien recréer l’archive tar.gz de manière à y inclure directement les fichiers Drupal (et non un dossier). 7Zip peut vous y aider :
Sélectionnez tous les fichiers Drupal, clic droit → 7Zip → Ajouter à l’archive. Choisissez le format tar. Ensuite, sélectionnez le fichier .tar, clic droit → 7Zip → Ajouter à l’archive, cette fois en gzip. Téléversez l’archive sur le serveur avec WinSCP, puis décompressez-la depuis le menu :
7. Parfois, il faut modifier le fichier settings.php manuellement, mais les instructions apparaîtront généralement sur la page de statut du site :
/admin/reports/status
8. Si vous aviez modifié les fichiers .htaccess ou robots.txt, réintégrez vos modifications.
9. Si vous aviez un favicon.ico personnalisé, recopiez-le.
10. Connectez-vous en tant qu’administrateur.
11. Lancez le script update.php, par exemple : https://drupalbook.org/update.php
12. Désactivez le mode maintenance.
/admin/config/development/maintenance
Si votre site est important, ne l’utilisez pas comme terrain d’essai. Créez une copie locale sur OpenServer. Essayez de faire la mise à jour en local pour vérifier qu’il n’y a pas d’erreurs. En cas de problème, laissez un commentaire, nous essaierons de trouver une solution.