====== Mise à jour manuelle ======

===== Mettre le site en mode maintenance =====

Doc: [[https://www.drupal.org/docs/8/update/update-core-manually]]

Se logger dans le site Drupal en tant qu'Administrateur.

Mettre le site en **mode maintenance** :
  * Menu **Configuration > Development > Maintenance mode**
  * Cocher la case **Put site into maintenance mode**
  * Cliquer sur **Save configuration**

===== Supprimer les anciens fichiers =====

Dans un shell du serveur, aller dans le dossier où le site Drupal est installé, et supprimer les dossiers **core** et **vendor**.

<code bash>
sudo rm -R core/
sudo rm -R vendor/
</code>

Supprimer également les fichiers présents dans le dossier **racine** de Drupal, sauf ceux qu'on a ajouté manuellement.

Si on a modifié **.htaccess**, **composer.json**, **robots.txt** etc... faire un backup de ces fichiers afin de les réintroduire après la mise à jour.

===== Installer la nouvelle version =====

Dans le shell du serveur, taper cette commande pour télécharger l'archive (remplacer le numéro de version par la dernière version disponible) :

<code bash>
sudo wget https://ftp-origin.drupal.org/files/projects/drupal-8.7.4.tar.gz
</code>

Décompresser ce fichier dans un dossier séparé. Copier le contenu entier de ce nouveau dossier dans le dossier où est installé le site. Réécrire tous les fichiers existants, car de toute façon tout ce qui est configuration et personnalisation ne fait pas partie du fichier compressé.

**Important:** changer le propriétaire des dossiers **modules**, **sites** et **themes** :

<code bash>
sudo chown -R www-data:www-data modules/ sites/ themes/
</code>

Remettre les fichiers **.htaccess**, **composer.json**, **robots.txt** etc... que l'on avait précédemment sauvegardé.

===== Mise à jour de la base de données =====

Visiter la page **/update.php** du site, cela va mettre à jour les tables dans la base de données. Il est nécessaire d'être resté connecté au site en tant qu'Administrateur, si ce n'est pas le cas, suivre la procédure indiquée dans la documentation de Drupal (en lien au début de cette page).

===== Vérification et fin =====

Vérifier que tout s'est déroulé comme prévu : **Reports > Status report**.

Désactiver le mode maintenance : **Configuration > Development > Maintenance mode**.

Supprimer l'archive téléchargée ainsi que le dossier d'extraction temporaire de l'archive.

**- Fin -**