PhpBB Lab Académie

Comprendre comment adapter l’installation locale déjà apprise à un hébergement web, identifier les valeurs fournies par l’hébergeur et préparer une nouvelle installation sans confondre les exemples locaux avec les paramètres réels du serveur.

Pourquoi cette leçon est-elle un complément ?

Vous savez maintenant installer phpBB sur votre propre ordinateur avec WampServer.

Vous avez déjà appris à préparer :

- les fichiers de phpBB ;
- une base de données ;
- un utilisateur SQL ;
- un compte administrateur ;
- les premiers réglages du forum ;
- une sauvegarde.

Sur un hébergement web, le principe reste le même.

Ce qui change surtout, ce sont les valeurs à utiliser.

Au lieu de travailler avec :

localhost
127.0.0.1
C:\wamp64\www

vous utiliserez les informations fournies par votre hébergeur.

Cette leçon ne vous demande pas d’acheter un hébergement. Elle vous apprend simplement à reconnaître les éléments nécessaires lorsque vous voudrez installer un forum accessible sur Internet.

1. Installation locale et hébergement : qu’est-ce qui reste identique ?

Sur votre ordinateur, phpBB avait besoin :

- de ses fichiers ;
- de PHP ;
- d’une base MySQL ou MariaDB ;
- d’un utilisateur SQL ;
- d’une adresse permettant d’ouvrir le forum.

Sur un hébergement web, il a besoin des mêmes éléments.

La différence est simplement leur emplacement.

En local :

les fichiers, PHP et la base fonctionnent sur votre ordinateur

Sur un hébergement :

les fichiers, PHP et la base fonctionnent sur un serveur distant

Vous pouvez fermer votre ordinateur sans arrêter le forum : le serveur de l’hébergeur continue de fonctionner.

2. Ne pas recopier les valeurs de WampServer

C’est le point le plus important de cette leçon.

Les valeurs utilisées pendant le cours local étaient des exemples propres à votre ordinateur.

Par exemple :

C:\wamp64\www
localhost
127.0.0.1
phpbb_ecole
phpbb_ecole

Sur un hébergement, ces valeurs peuvent être totalement différentes.

Votre hébergeur peut vous donner, par exemple :

Dossier web : public_html
Base : client123_forum
Utilisateur SQL : client123_forumuser
Serveur SQL : mysql12.hebergeur.example

Ces noms sont seulement des exemples.

Vous devez toujours utiliser les valeurs réelles indiquées dans votre panneau d’hébergement.

3. Commencer par choisir l’adresse du forum

Avant de transférer des fichiers, vous devez savoir à quelle adresse votre forum sera accessible.

Il peut s’agir par exemple :

- du domaine principal ;
- d’un sous-domaine ;
- d’un sous-dossier.

Exemples :

https://www.exemple.com/
https://forum.exemple.com/
https://www.exemple.com/forum/

L’adresse choisie doit correspondre à un dossier précis sur le serveur.

Votre hébergeur indique généralement ce dossier dans son panneau de gestion.

Il peut porter un nom comme :

public_html
www
htdocs

Ne supposez pas que le dossier s’appelle forcément

www

.

4. Vérifier la version de PHP

Dans le panneau de l’hébergeur, cherchez la version de PHP utilisée par le site ou le domaine choisi.

Dans notre parcours consacré à phpBB 3.3.17, nous avons travaillé avec PHP 8.3.

Si votre hébergeur permet de choisir plusieurs versions, vérifiez quelle version est réellement affectée au site.

Ne vous contentez pas de voir qu’une version est disponible dans une liste.

Le site doit réellement l’utiliser.

Si plusieurs sites partagent le même réglage PHP, vérifiez les besoins des autres sites avant de modifier cette valeur.

5. Préparer une nouvelle base de données

Sur un hébergement, la création d’une base se fait généralement dans le panneau du fournisseur.

Vous devez préparer :

- une nouvelle base ;
- un utilisateur SQL ;
- un mot de passe pour cet utilisateur ;
- les droits de cet utilisateur sur cette base.

C’est exactement le même principe que dans les leçons précédentes.

La différence est que l’hébergeur peut imposer les noms.

Par exemple, vous demandez une base appelée :

forum

mais le panneau crée :

client123_forum

Dans ce cas, le vrai nom de la base est :

client123_forum

C’est ce nom complet qu’il faudra saisir dans l’installateur de phpBB.

6. Relever l’hôte SQL

En local, nous utilisions :

127.0.0.1

parce que phpBB et la base se trouvaient sur le même ordinateur.

Sur un hébergement, le serveur SQL peut avoir une autre adresse.

L’hébergeur peut par exemple indiquer :

localhost

ou :

mysql12.hebergeur.example

ou une autre valeur.

Ne choisissez pas vous-même cette adresse.

Notez exactement celle fournie par le panneau d’hébergement.

Retenez :

Hôte SQL = adresse du serveur de bases de données

7. Relever le port seulement s’il est nécessaire

Certains hébergeurs utilisent le port habituel de MySQL ou MariaDB et ne vous demandent pas de le préciser.

D’autres affichent un numéro de port.

S’il est fourni, notez-le.

S’il n’est pas indiqué et que le formulaire de phpBB permet de laisser le champ vide pour utiliser la valeur par défaut, suivez les informations de votre hébergeur.

Ne recopiez pas automatiquement le port de votre installation WampServer.

8. Préparer une petite fiche avant d’installer

Avant de transférer phpBB, notez les informations suivantes.

Par exemple :

Adresse du forum :
https://forum.exemple.com/

Dossier web :
valeur indiquée par l’hébergeur

Version PHP :
version réellement utilisée

Hôte SQL :
valeur indiquée par l’hébergeur

Nom de la base :
nom complet réel

Utilisateur SQL :
nom complet réel

Port SQL :
valeur fournie, si nécessaire

Conservez le mot de passe SQL séparément dans un endroit privé.

Ne l’écrivez pas dans une note destinée à être publiée ou partagée.

Cette fiche évite de deviner des valeurs pendant l’installation.

9. Activer HTTPS avant l’ouverture du forum

Un forum public doit utiliser une connexion sécurisée.

L’adresse doit donc normalement commencer par :

https://

HTTPS chiffre les échanges entre le navigateur et le site.

Votre hébergeur propose généralement une fonction permettant d’activer un certificat pour votre domaine.

Activez ce certificat selon les instructions du fournisseur.

Ensuite, ouvrez l’adresse HTTPS dans votre navigateur.

Le résultat attendu est simple :

la page doit s’ouvrir sans avertissement de certificat.

Si le navigateur affiche une alerte de sécurité, ne l’ignorez pas pour poursuivre l’installation publique.

Vérifiez d’abord la configuration du domaine et du certificat.

10. Transférer les fichiers de phpBB

Vous avez déjà appris à utiliser le pack complet de phpBB.

Le principe reste identique.

Téléchargez et extrayez le pack correspondant à la version du cours.

Vous devez ensuite placer le contenu de la racine de phpBB dans le dossier web prévu pour votre forum.

Votre hébergeur peut proposer :

- un gestionnaire de fichiers dans son panneau ;
- un accès de transfert de fichiers.

Pour un débutant, le gestionnaire de fichiers du panneau est souvent le moyen le plus simple.

Si vous utilisez un logiciel de transfert, utilisez les informations fournies par l’hébergeur.

Nous n’allons pas apprendre ici tous les protocoles de transfert : l’objectif est uniquement de placer les fichiers au bon endroit.

11. Vérifier le niveau des fichiers

Après le transfert, le dossier du forum doit contenir directement les fichiers principaux de phpBB.

Par exemple :

index.php
config.php
adm
includes
install
language
phpbb
styles
vendor

Si l’adresse prévue est :

https://www.exemple.com/forum/

mais que les fichiers se trouvent en réalité dans :

forum/phpBB3/index.php

vous avez probablement conservé un dossier intermédiaire inutile.

Le principe est le même que dans l’installation locale :

index.php doit se trouver directement à la racine du forum prévu.

12. Ouvrir l’assistant d’installation

Une fois les fichiers en place, ouvrez l’adresse HTTPS de votre forum.

Si nécessaire, ajoutez :

/install/

Par exemple :

https://www.exemple.com/forum/install/

L’assistant de phpBB doit apparaître.

À partir de là, vous retrouvez les étapes déjà apprises :

- création de l’administrateur ;
- configuration de la base ;
- configuration du serveur ;
- réglages des courriels ;
- nom du forum.

Vous n’avez pas besoin de réapprendre l’assistant depuis zéro.

Vous devez simplement remplacer les valeurs locales par les valeurs réelles de votre hébergement.

13. Adapter la configuration de la base

Sur l’écran de configuration de la base, utilisez les informations notées dans votre fiche.

Par exemple :

Type : MySQL avec l’extension MySQLi
Hôte : valeur fournie par l’hébergeur
Port : valeur fournie si nécessaire
Utilisateur : utilisateur SQL réel
Mot de passe : mot de passe SQL
Base : nom complet réel de la base
Préfixe : phpbb_

Ne saisissez pas

127.0.0.1

uniquement parce que cette valeur était utilisée dans WampServer.

Sur un hébergement, elle n’est correcte que si le fournisseur vous indique réellement une connexion locale de ce type.

14. Adapter la configuration du serveur web

Cette fois, le forum est destiné à être accessible sur Internet.

L’assistant doit donc correspondre à l’adresse publique réelle.

Par exemple :

Protocole : https
Nom du serveur : forum.exemple.com
Chemin : /

ou, pour un sous-dossier :

Protocole : https
Nom du serveur : www.exemple.com
Chemin : /forum

Les valeurs exactes dépendent de votre installation.

Comparez toujours ce que phpBB propose avec l’adresse réellement utilisée dans le navigateur.

15. Utiliser les cookies sécurisés avec HTTPS

Dans notre installation locale en HTTP, nous avions laissé les cookies sécurisés désactivés.

Sur un forum public correctement accessible en HTTPS, les cookies sécurisés doivent être adaptés à cette connexion HTTPS.

Ne recopiez donc pas aveuglément le réglage de WampServer.

L’idée à retenir est :

HTTP local et HTTPS public ne se configurent pas exactement de la même manière.

16. Configurer les courriels avant d’ouvrir les inscriptions

Sur notre installation locale, nous avions désactivé les courriels.

Pour un forum public, les courriels peuvent être importants pour :

- l’activation des comptes ;
- les notifications ;
- la récupération d’un accès.

Votre hébergeur peut fournir un serveur de messagerie ou des paramètres SMTP.

SMTP est le service auquel phpBB peut confier l’envoi des courriels.

Si votre fournisseur vous donne des paramètres SMTP, recopiez exactement :

- le nom du serveur ;
- le port ;
- le mode de sécurité ;
- le nom d’utilisateur ;
- le mot de passe.

Ces valeurs n’ont aucun rapport avec les identifiants de la base de données.

17. Tester réellement les courriels

Une configuration enregistrée n’est pas une preuve que les courriels arrivent.

Lorsque phpBB propose un envoi de test, utilisez une adresse de messagerie que vous contrôlez.

Vérifiez ensuite la réception réelle.

Regardez également dans le dossier des courriers indésirables.

Si le message n’arrive pas, relevez l’erreur affichée avant de modifier des paramètres au hasard.

18. Supprimer le dossier install après la réussite

Comme en local, attendez que phpBB confirme clairement la fin de l’installation.

Ensuite seulement, retirez le dossier :

install

de cette installation.

Conservez :

config.php

et tous les autres fichiers nécessaires au forum.

19. Tester avec un membre ordinaire

Avant d’ouvrir le forum à une communauté, refaites le test appris dans la leçon précédente.

Créez un compte membre.

Vérifiez :

- son inscription ;
- son activation selon la méthode choisie ;
- sa connexion ;
- la création d’un sujet ;
- l’ajout d’une réponse ;
- la réception des courriels si le forum les utilise.

Testez également le forum depuis un autre appareil si possible.

L’objectif est de voir le site comme un vrai visiteur, pas seulement comme l’administrateur.

20. Faire une première sauvegarde

Avant d’inviter des membres, préparez aussi une première sauvegarde.

Le principe reste exactement celui de la leçon précédente :

sauvegarde = fichiers + base de données

Utilisez les outils de votre hébergeur pour récupérer :

- une copie des fichiers du forum ;
- un export complet de la base.

Conservez ces sauvegardes dans un emplacement privé.

21. Installation neuve et migration ne sont pas la même chose

Cette leçon concerne une nouvelle installation.

Si vous possédez déjà un forum avec :

- des membres ;
- des sujets ;
- des messages ;
- des pièces jointes ;
- des réglages ;

et que vous souhaitez le déplacer vers un autre serveur, il ne faut pas simplement relancer l’assistant d’installation sur une nouvelle base.

Cette opération s’appelle une migration.

Une migration doit préserver les données existantes et demande une procédure spécifique.

Elle sera étudiée séparément.

22. Ce qu’il faut retenir

Installer phpBB sur un hébergement n’est pas un nouveau monde complètement différent.

Vous utilisez toujours :

- des fichiers ;
- PHP ;
- une base ;
- un utilisateur SQL ;
- un administrateur phpBB ;
- un navigateur.

La différence essentielle est la suivante :

en local, vous connaissez vous-même les valeurs ; sur un hébergement, vous devez utiliser celles fournies par le serveur.

Si vous retenez cette règle, vous éviterez une grande partie des erreurs de configuration.

Une association veut installer un nouveau forum sur un hébergement.

Son panneau indique :

Adresse : https://forum.exemple.com/
PHP : 8.3
Base : asso_forum
Utilisateur SQL : asso_forumuser
Hôte SQL : mysql7.hebergeur.example

L’association ne saisit donc pas

127.0.0.1

simplement parce que cette valeur était utilisée dans WampServer.

Elle transfère les fichiers de phpBB dans le dossier correspondant au sous-domaine.

Elle vérifie que

index.php

se trouve directement dans ce dossier.

Elle ouvre ensuite :

https://forum.exemple.com/install/

et reprend l’assistant déjà appris.

Dans les paramètres de base, elle utilise les valeurs réelles fournies par l’hébergeur.

Après l’installation, elle vérifie HTTPS, les courriels et les actions d’un membre avant d’ouvrir le forum au public.

Si vous disposez déjà d’un hébergement, préparez une fiche avec les informations réelles suivantes :

1. Adresse HTTPS prévue pour le forum.

2. Dossier web correspondant à cette adresse.

3. Version de PHP réellement utilisée.

4. Nom complet de la base.

5. Nom complet de l’utilisateur SQL.

6. Hôte SQL.

7. Port SQL, s’il est indiqué.

8. Méthode disponible pour transférer les fichiers.

9. Méthode prévue pour envoyer les courriels.

Ne recopiez aucun mot de passe dans votre réponse.

Si vous ne disposez pas d’un hébergement, répondez simplement à ces questions :

1. Pourquoi ne faut-il pas recopier automatiquement

127.0.0.1

depuis le cours WampServer ?

2. Pourquoi le vrai nom d’une base peut-il être différent du nom que vous aviez demandé ?

3. Pourquoi faut-il vérifier HTTPS et les courriels avant d’ouvrir un forum au public ?

Le principe d’une installation phpBB reste le même en local et sur un hébergement.

Ce sont surtout les valeurs utilisées qui changent.

Sur un hébergement, il faut reprendre les informations réelles du fournisseur pour :

- le dossier web ;
- PHP ;
- la base ;
- l’utilisateur SQL ;
- l’hôte SQL ;
- le port éventuel ;
- le domaine.

Les exemples

localhost

,

127.0.0.1

et

C:\wamp64\www

appartiennent au parcours local et ne doivent pas être recopiés automatiquement.

Un forum public doit être vérifié en HTTPS.

Les courriels doivent être réellement testés si les inscriptions ou la récupération de compte en dépendent.

Une installation neuve et une migration de forum existant sont deux opérations différentes.

Avant l’ouverture, testez le forum avec un membre ordinaire et préparez une sauvegarde des fichiers et de la base.