[Mise à niveau] Procédure de mise à niveau d'un forum phpBB

Retrouvez ici quelques tutoriels pour vos forums phpBB
Avatar du membre
Fred Fred
Fondateur
Messages: []
Enregistré depuis: 4 ans 9 mois
Identité: Fred Rimbert
Forum phpBB: https://caforum.fr
Localisation: Le Lude - Pays de la Loire
Intérêt: GitHub

Procédure de mise à niveau d'un forum phpBB

Message par Fred »

Avant de faire une mise à niveau il faut s'assurer que les éléments du forum sont compatibles (version de PHP, extensions, styles)
La mise à niveau est le fait de changer de branche de phpBB 3.2.x > 3.3.x
Cette procédure vaut aussi pour mise à jour de version 3.3.0 > 3.3.1 En premier lieu

Faire une sauvegarde de la BDD avec phpMyAdmin, ainsi que les fichiers du forum.
Si votre base de données est trop volumineuse utilisez la sauvegarde MySQL : Base de connaissance - Sauvegarde MySQL - Sauvegarde et restauration de base de donnée

phpBB 3.2.x
Vérifier la version de php : 5.4.x jusqu’à 7.2.x
phpBB 3.3.x
Vérifier la version de php : >= 7.1.3
  • PHP 7.2.0 au minimum sera requis pour les versions 3.3.11 (et supérieur) de phpBB
En raison du développement ultérieur de la base de code, l’utilisation de certaines extensions peut entraîner des incompatibilités lors de l’utilisation d’une version supérieure de phpBB. Il est donc conseillé de vérifier la compatibilité des extensions installées dans le forum avec la nouvelle version de phpBB avant la procédure de mise à jour, et si nécessaire de les désactiver jusqu’à la fin de l'opération, ou, si nécessaire, de les désinstaller complètement (désactiver + supprimer les données de travail).
Il en va de même pour les autres styles disponibles en plus du prosilver.
Mettre à jour les fichiers

Désactive toutes les extensions et remettre le style Prosilver par défaut

Depuis le serveur on supprime le contenu du répertoire racine du forum sauf les dossiers :
  • ext
  • files
  • images
  • store
  • styles (si vous avez des styles additionnels)
  • et le fichier config.php
:warning: Important
Ne pas oublier, s'ils sont présents sur le forum, de conserver le fichier robots.txt et le fichier google servant au référencement.
Envoyer l'archive

Récupérer l'archive du pack complet correspondant à la version de phpBB qui sera installée sur le forum.
Après extraction du fichier .zip, en FTP, envoyer les dossiers et les fichiers de phpBB, en utilisant le mode binaire de FileZilla,
3.2.x
|
3.3.x
sauf les dossiers :
  • ext
  • files
  • images
  • store
  • et le fichier config.php
En lieu et place des anciens dossiers/fichiers.
C’est-à-dire, dans le répertoire /phpBB3 à la racine du forum, en s'assurant d’écraser les fichiers existants.
Si le répertoire contenant les dossiers et fichiers du forum à été renommé c'est dans ce répertoire qu'il faut opérer
replace.png
:exclamation: Avant de lancer la mise à jour.

Dans les dossier files et store du serveur, remplacer le fichier .htaccess par celui présent dans les dossiers de l'archive.
Dans le dossier images du serveur on se rend ici : images/avatar/upload et on remplace le fichier .htaccess par celui présent dans le dossier de l'archive.

Si le dossier download n'a pas été remplacé sur le serveur, remplacer le fichier file.php par celui du dossier de l'archive

Assurez-vous que le fichier .htaccess soit bien inclus dans le téléchargement sur le serveur. Certains clients FTP n’affichent pas les fichiers dont les noms commencent par un point, vous devrez vérifier que l’affichage des fichiers masqués est bien activé.



Mettre à jour la base de données
Pour les forums de taille importante, vous souhaiterez peut-être effectuer la mise à jour via la ligne de commande au lieu d'utiliser le navigateur. Depuis la racine de votre forum, exécutez la commande suivante :
php ./bin/phpbbcli.php db:migrate --safe-mode
Il reste alors à mettre à jour la base de données en pointant sur le dossier /install
C'est à dire URL-du-forum/répertoire-du-forum/install/app.php ou alternativement URL-du-forum/répertoire-du-forum/install/
Choisir l'onglet mise à jour et suivre les instructions.


Image


Un message s'affiche informant qu'aucun répertoire de mise à jour n'a été trouvé ! C'est tout à fait normal car la version de php à été updatée manuellement.
Sélectionne Mettre à jour uniquement la base de données et clique sur Envoyer

Image

Lorsque la base de données sera à jour, tu auras ceci

Image

Supprime le dossier /install et clique sur Accéder au panneau d'administration

Tu auras certainement un message t'informant que tu n'as pas les permissions d'administration, ignore et connecte toi au forum

Image

Vas au panneau d'administration et vérifie que la version est bien à jour

Image



Après la mise à jour

Réactive les extensions une à une en vérifiant la compatibilité, et mets ton/tes style personnalisé(s) à jour.
  • Si ton forum était sécurisé, ne pas oublier de modifier le fichier .htaccess pour la redirection
    HTTPS.
Vous n’avez pas les permissions nécessaires pour voir les fichiers joints à ce message.
Modifié en dernier par Fred le 23 oct. 2023, 07:45, modifié 6 fois. (Journal des éditions)
Raison: Notification de la version minimale de PHP à partir de la version 3.3.11 de phpBB