Mettre à jour phpBB sans perdre son forum : méthode sûre, sauvegarde et retour arrière
Une nouvelle version de phpBB est disponible.
Vous voulez profiter des correctifs de sécurité, des corrections de bugs ou des améliorations apportées par cette version.
Mais une question revient immédiatement :
« Est-ce que je risque de casser mon forum ? »
Une mise à jour phpBB correctement préparée n’est pas une opération hasardeuse.
Le danger vient surtout lorsque l’on mélange plusieurs méthodes, que l’on remplace des fichiers au hasard, que l’on oublie les extensions ou que l’on commence sans sauvegarde.
Ce tutoriel propose une méthode progressive pour préparer une mise à jour proprement et surtout pour pouvoir revenir en arrière si quelque chose se passe mal.
Principe essentiel :
Une mise à jour n’est réellement sûre que lorsque vous savez comment restaurer l’état précédent.
1. Une installation phpBB contient plusieurs éléments différents
Avant de parler de mise à jour, il faut comprendre ce que vous êtes en train de mettre à jour.
Un forum phpBB contient notamment :
les fichiers du moteur phpBB ;
la base de données ;
les extensions ;
les styles ;
les fichiers envoyés par les utilisateurs ;
les avatars ;
la configuration ;
le cache ;
éventuellement des personnalisations.
Mettre à jour uniquement les fichiers ne signifie donc pas forcément que toute l’installation est à jour.
Inversement, mettre à jour la base sans disposer des bons fichiers peut également créer une installation incohérente.
La cohérence entre les fichiers, la base de données, les extensions, les styles et la version PHP est essentielle.
2. Commencez par identifier votre version actuelle
Dans le panneau d’administration :
PCA → Général
phpBB affiche normalement la version actuellement utilisée.
Notez-la précisément.
Par exemple :
Code : Tout sélectionner
Version actuelle : phpBB 3.3.15Puis notez la version que vous souhaitez installer :
Code : Tout sélectionner
Version cible : phpBB 3.3.17Cela paraît évident, mais connaître précisément le point de départ évite beaucoup d’erreurs.
3. Vérifiez la version PHP avant la mise à jour
Une nouvelle version de phpBB peut avoir des exigences différentes concernant PHP.
Avant de remplacer quoi que ce soit, vérifiez :
la version PHP réellement utilisée par le site ;
la version PHP compatible avec la version cible de phpBB ;
la compatibilité de vos extensions avec cette version PHP.
Si vous avez un accès SSH :
Code : Tout sélectionner
php -vpeut donner une première indication.
Attention : la version PHP utilisée en ligne de commande peut être différente de celle utilisée par Apache ou PHP-FPM.
4. Vérifiez les extensions avant phpBB
C’est probablement l’étape la plus souvent négligée.
Imaginez :
Code : Tout sélectionner
phpBB actuel : 3.3.15
Extension A : compatible
Extension B : compatible
Extension C : abandonnée depuis plusieurs annéesVous mettez phpBB à jour.
Le moteur fonctionne parfaitement, mais l’extension C provoque maintenant une erreur fatale.
Le problème n’est alors pas forcément phpBB lui-même.
Avant la mise à jour, faites donc la liste de vos extensions et vérifiez pour chacune :
son nom ;
sa version ;
son auteur ;
sa dernière version disponible ;
sa compatibilité déclarée avec phpBB ;
sa compatibilité avec votre version PHP.
5. Une compatibilité déclarée n’est pas une garantie absolue
Le fichier composer.json d’une extension peut indiquer une plage de compatibilité.
C’est une information importante, mais cela ne remplace pas un vrai test.
Lorsque la mise à jour est importante, vérifiez également :
le sujet officiel de l’extension ;
son journal des versions ;
les éventuels problèmes signalés ;
la dernière date de maintenance.
6. Vérifiez également votre style
Les styles sont parfois oubliés pendant les mises à jour.
Un style ancien peut utiliser des templates devenus obsolètes ou ne plus être adapté à la nouvelle version de phpBB.
Si votre style hérite de prosilver, vérifiez qu’il reste compatible avec la version cible.
Ne conservez pas un prosilver ancien avec un cœur phpBB plus récent.
7. Faites une sauvegarde de la base de données
Avant toute mise à jour importante :
sauvegardez la base de données.
Elle contient notamment :
les utilisateurs ;
les forums ;
les sujets ;
les messages ;
les permissions ;
les groupes ;
les paramètres ;
les données des extensions.
Une sauvegarde utile doit surtout être restaurable.
8. Sauvegardez également les fichiers
La base ne contient pas tout.
Sauvegardez également vos fichiers, notamment :
config.php ;
ext/ ;
styles/ ;
files/ ;
images/ ;
store/ ;
vos éventuels fichiers personnalisés.
Un vrai retour arrière peut nécessiter à la fois l’ancienne base et les anciens fichiers.
9. Protégez particulièrement config.php
Le fichier config.php permet à phpBB de se connecter à sa base de données.
Il ne doit pas être remplacé aveuglément.
Gardez toujours une copie de votre config.php actuel.
Ne publiez jamais son contenu complet dans un forum de support.
10. Évitez de modifier le cœur de phpBB
Une installation propre utilise les extensions, les styles, les événements et la configuration pour ajouter des fonctionnalités.
Modifier directement les fichiers du cœur rend les mises à jour beaucoup plus difficiles.
Dans la mesure du possible, remplacez les modifications du cœur par des extensions.
11. Choisissez une seule méthode de mise à jour
Ne commencez pas avec une méthode pour terminer avec une autre.
Évitez par exemple de mélanger plusieurs packages ou de conserver volontairement certains anciens fichiers sans savoir pourquoi.
Choisissez une procédure adaptée à votre version de départ et à votre version cible, puis suivez-la jusqu’au bout.
12. Consultez les instructions correspondant à votre version
Une procédure écrite pour une ancienne branche de phpBB n’est pas forcément adaptée à phpBB 3.3.
Consultez les instructions correspondant réellement à votre version cible.
13. Testez si possible sur une copie
Pour un forum important, créez d’abord une copie de test.
Cette copie doit utiliser :
des fichiers séparés ;
une base de données séparée ;
un domaine ou sous-domaine de test.
Vous pourrez alors découvrir les incompatibilités avant de toucher au forum utilisé par vos membres.
14. Une copie de test doit utiliser une base séparée
Ne faites pas fonctionner votre test et votre production sur la même base en écriture.
Une migration exécutée sur le test pourrait modifier directement votre production.
15. Placez le forum en maintenance pendant le basculement
Au moment de la vraie mise à jour, empêchez temporairement les nouvelles publications.
Sinon un membre pourrait publier après votre dernière sauvegarde et perdre son message si vous devez revenir en arrière.
16. Faites une dernière sauvegarde juste avant la mise à jour
La bonne séquence est :
mise en maintenance ;
sauvegarde finale ;
mise à jour.
Ainsi, votre point de restauration est aussi récent que possible.
17. Désactiver les extensions n’est pas supprimer leurs données
Dans phpBB :
Désactiver signifie arrêter temporairement l’extension tout en conservant ses données.
Supprimer les données peut déclencher les migrations de désinstallation et supprimer des données propres à l’extension.
Pour préparer une mise à jour, ne supprimez pas les données d’une extension sans raison précise.
18. Remplacez les fichiers proprement
Une copie de fichiers interrompue peut produire une installation mélangeant plusieurs versions.
Vous pouvez alors rencontrer des erreurs telles que :
Class not found ;
Method not found ;
Service not found ;
Template error ;
Fatal error.
Si votre transfert échoue, ne considérez pas l’opération comme terminée.
19. Attention aux dossiers contenant vos données
Certains dossiers contiennent des données spécifiques à votre installation.
Ne les remplacez pas aveuglément par des dossiers vides provenant d’une archive.
Suivez toujours la procédure adaptée au package phpBB utilisé.
20. La base de données doit également être mise à jour
Après le remplacement des fichiers, phpBB peut avoir besoin d’exécuter des migrations de base de données.
Ne considérez donc pas la mise à jour comme terminée simplement parce que la page d’accueil s’affiche.
21. N’interrompez pas une migration au hasard
Une migration peut prendre du temps.
Si elle semble bloquée, consultez les logs et identifiez l’étape précise avant de relancer ou de redémarrer quoi que ce soit.
22. Attention aux installations incohérentes
Une installation peut se retrouver avec :
Code : Tout sélectionner
Fichiers : phpBB 3.3.17
Base de données : état correspondant encore à une ancienne versionLe forum peut alors sembler fonctionner sur certaines pages tout en produisant des erreurs ailleurs.
Les fichiers et la base doivent correspondre à un état cohérent.
23. Purgez le cache après la mise à jour
Si vous disposez de la CLI phpBB :
Code : Tout sélectionner
php bin/phpbbcli.php cache:purgeLe cache peut contenir d’anciennes versions compilées de templates, services ou paramètres.
24. Vérifiez les dossiers d’écriture
Après une migration ou une copie de fichiers, contrôlez les permissions nécessaires à phpBB.
Cela concerne notamment, selon votre installation :
cache/ ;
files/ ;
store/ ;
images/avatars/upload/.
Ne mettez jamais tout le forum en 777 pour résoudre un problème de permissions.
25. Testez comme visiteur
Vérifiez :
la page d’accueil ;
les catégories ;
les forums ;
les sujets ;
les images ;
les pièces jointes publiques ;
la navigation.
26. Testez comme membre
Avec un compte utilisateur normal, testez :
la connexion ;
la déconnexion ;
la création d’un sujet ;
une réponse ;
l’édition ;
les notifications ;
les messages privés ;
les pièces jointes.
27. Testez ensuite le PCA
Vérifiez notamment :
la gestion des forums ;
les utilisateurs ;
les groupes ;
les permissions ;
les extensions ;
les styles ;
les paramètres serveur.
28. Réactivez les extensions progressivement
Si vous les aviez désactivées, réactivez-les une par une lorsque vous avez un doute.
Cela permet d’identifier immédiatement celle qui provoque éventuellement un problème.
29. Surveillez les journaux
Après la mise à jour, consultez les journaux PHP et serveur.
Une erreur peut exister sans être immédiatement visible pour les visiteurs.
30. Vérifiez les tâches cron
Si vous utilisez un cron serveur, vérifiez qu’il pointe toujours vers le bon chemin après une migration ou un déplacement de phpBB.
31. Vérifiez les e-mails
Testez votre système d’e-mail lorsque votre configuration le permet.
Une mise à jour peut parfois coïncider avec un changement de PHP, SMTP ou serveur.
32. Vérifiez vos URLs
Si vous avez également changé de domaine ou de serveur, vérifiez :
HTTPS ;
le nom de domaine ;
les cookies ;
le chemin du script ;
les redirections ;
les URLs canoniques si vous utilisez une extension SEO.
33. Gardez votre sauvegarde
Ne supprimez pas vos anciennes sauvegardes simplement parce que le forum fonctionne depuis cinq minutes.
Certains problèmes apparaissent seulement lors d’un cron, d’un e-mail ou d’une action particulière.
34. Quand faut-il revenir en arrière ?
Une petite erreur identifiable ne nécessite pas forcément une restauration complète.
En revanche, envisagez un retour arrière si :
la migration de base est sérieusement interrompue ;
plusieurs fichiers sont manquants ;
vous ne savez plus quelles versions ont été copiées ;
des données semblent endommagées ;
la réparation devient plus risquée que la restauration.
35. Un vrai retour arrière restaure un ensemble cohérent
Évitez de mélanger :
Code : Tout sélectionner
ancienne base + nouveaux fichiersou :
Code : Tout sélectionner
nouvelle base + anciens fichiersL’objectif est de retrouver ensemble les fichiers et la base correspondant au même état.
36. Exemple d’une bonne procédure
Vérifier la version PHP.
Vérifier les extensions.
Vérifier le style.
Sauvegarder la base.
Sauvegarder les fichiers.
Tester sur une copie.
Corriger les incompatibilités.
Planifier la maintenance.
Faire une sauvegarde finale.
Effectuer la mise à jour.
Terminer les migrations.
Purger le cache.
Tester comme visiteur.
Tester comme membre.
Tester le PCA.
Réactiver progressivement les extensions.
Vérifier les logs.
Conserver la sauvegarde.
37. Exemple d’une mauvaise procédure
Télécharger une archive au hasard.
Écraser tout le serveur.
Recharger immédiatement la page.
Constater une erreur 500.
Modifier plusieurs paramètres.
Supprimer une extension.
Changer PHP.
Modifier la base.
Demander ensuite de l’aide sans savoir ce qui a réellement changé.
Cette méthode rend le diagnostic beaucoup plus difficile.
38. Ne reportez pas éternellement les mises à jour
Conserver pendant des années un ancien phpBB, un ancien PHP, de vieilles extensions et un vieux style finit généralement par rendre la future migration beaucoup plus difficile.
Des mises à jour régulières et maîtrisées sont généralement plus simples qu’une énorme migration après plusieurs années.
39. Informations à fournir si la mise à jour échoue
Lorsque vous demandez de l’aide, fournissez au minimum :
Code : Tout sélectionner
Version phpBB avant mise à jour :
Version phpBB cible :
Version PHP :
Base de données :
Serveur Web :
Méthode de mise à jour utilisée :
Étape exacte où l’erreur apparaît :
Message d’erreur :
Dernière erreur correspondante dans les logs :
Extensions actives :
Style utilisé :
Sauvegarde disponible : oui/nonNe publiez jamais votre mot de passe SQL, vos cookies de session, vos clés privées ou votre fichier config.php complet.
40. Checklist avant la mise à jour
Je connais ma version phpBB actuelle.
Je connais la version cible.
J’ai vérifié PHP.
J’ai vérifié mes extensions.
J’ai vérifié mon style.
J’ai sauvegardé la base.
J’ai sauvegardé les fichiers.
J’ai conservé config.php.
Je sais quelle méthode de mise à jour j’utilise.
J’ai testé sur une copie si le forum est important.
Je sais comment revenir en arrière.
41. Checklist après la mise à jour
Les migrations sont terminées.
Le cache a été purgé.
La page d’accueil fonctionne.
Les forums fonctionnent.
Les sujets fonctionnent.
La connexion fonctionne.
La publication fonctionne.
Le PCA fonctionne.
Les extensions ont été contrôlées.
Le style fonctionne.
Les e-mails ont été vérifiés.
Le cron fonctionne.
Les logs ne montrent pas d’erreur critique nouvelle.
La sauvegarde précédente est encore conservée.
À retenir
Une mise à jour phpBB ne devrait jamais être :
télécharger → écraser → espérer
Elle devrait être :
comprendre → vérifier → sauvegarder → tester → mettre à jour → contrôler
Les trois éléments les plus importants sont :
1. Une sauvegarde complète
Base de données et fichiers.
2. La compatibilité
phpBB, PHP, extensions et styles doivent rester cohérents.
3. Un retour arrière préparé
Vous devez savoir comment retrouver l’état précédent avant même de commencer.
Avec cette méthode, une mise à jour cesse d’être une opération stressante.
Elle devient une procédure technique maîtrisée.