PhpBB Lab Académie

Comprendre les informations demandées par phpBB pour se connecter à MySQL ou MariaDB, renseigner chaque champ avec les valeurs préparées auparavant et vérifier que l’assistant parvient à accéder à la base du forum.

Nous reprenons l’installation là où nous l’avons laissée

À la fin de la leçon précédente, phpBB a accepté les informations de votre compte administrateur.

L’assistant affiche maintenant :

Configuration de la base de données

Cette page sert à répondre à une question simple :

Comment phpBB peut-il se connecter à la base que nous avons préparée ?

Nous allons remplir les champs un par un.

Ne cherchez pas à tout mémoriser. L’objectif est de comprendre le rôle de chaque information et de savoir où retrouver sa valeur.

1. Reprendre les informations déjà préparées

Dans les leçons précédentes, nous avons créé :

- une base de données ;
- un utilisateur SQL réservé à phpBB ;
- un mot de passe pour cet utilisateur ;
- un accès local à MySQL ou MariaDB.

Dans notre exemple, nous avons utilisé :

Base : phpbb_ecole
Utilisateur SQL : phpbb_ecole
Hôte local : 127.0.0.1

Vous avez également choisi un mot de passe SQL personnel.

Gardez ces informations à portée de main.

2. Comprendre ce que phpBB cherche à faire

phpBB est installé dans des fichiers sur votre ordinateur.

Les messages, les comptes et les réglages du forum seront, eux, enregistrés dans la base de données.

Pour travailler avec cette base, phpBB doit donc savoir :

- quel type de serveur de bases de données il utilise ;
- où se trouve ce serveur ;
- avec quel utilisateur il peut s’y connecter ;
- quel mot de passe utiliser ;
- dans quelle base il doit travailler.

C’est exactement ce que le formulaire vous demande.

3. Choisir le type de base de données

Le premier champ s’appelle :

Type de base de données

Avec notre environnement WampServer, nous utilisons MySQL ou MariaDB.

Pour ces deux serveurs, choisissez dans l’assistant :

MySQL avec l’extension MySQLi

Le mot MySQLi désigne le moyen utilisé par PHP pour communiquer avec MySQL ou MariaDB.

Vous n’avez rien à programmer avec MySQLi.

Il suffit ici de choisir cette option.

Si elle n’apparaît pas dans la liste, ne choisissez pas un autre type au hasard. Cela signifie qu’il faut d’abord vérifier la configuration PHP de votre environnement.

4. Indiquer où se trouve le serveur de bases de données

Le champ suivant porte un nom proche de :

Serveur de base de données ou DSN

Dans notre installation locale, saisissez :

127.0.0.1

Cette adresse signifie :

le serveur de bases de données se trouve sur le même ordinateur que phpBB.

C’est aussi l’adresse que nous avons utilisée lorsque nous avons créé l’utilisateur SQL dans la leçon 7.

Le terme DSN peut apparaître dans le libellé, mais nous n’avons pas besoin de construire un DSN dans notre exercice. Nous utilisons simplement l’adresse locale.

5. Comprendre le port sans compliquer les choses

Le formulaire comporte également un champ :

Port du serveur

Un même ordinateur peut faire fonctionner plusieurs services.

Le port est un numéro qui permet de préciser lequel de ces services on veut joindre.

Vous pouvez comparer cela à un immeuble :

- l’adresse indique l’immeuble ;
- le port indique la porte du service recherché.

MySQL utilise très souvent le port :

3306

Mais il ne faut pas considérer ce nombre comme universel. Une installation peut utiliser un autre port, notamment si plusieurs serveurs de bases de données fonctionnent sur le même ordinateur.

Comment retrouver le port utilisé ?

Ouvrez phpMyAdmin dans un autre onglet.

Sur la page d’accueil ou dans les informations du serveur, recherchez les informations de connexion au serveur MySQL ou MariaDB. Le numéro de port peut y être indiqué.

Si votre installation WampServer utilise son port standard et que phpMyAdmin indique 3306, saisissez :

3306

Si un autre numéro est indiqué, utilisez ce numéro.

Ne recopiez pas le port 80 ou 443 : ces numéros concernent le serveur web, pas MySQL ou MariaDB.

6. Indiquer le nom de l’utilisateur SQL

Le champ :

Nom d’utilisateur

attend le compte SQL créé dans la leçon 7.

Dans notre exemple :

phpbb_ecole

Attention : ce n’est pas le nom de votre administrateur phpBB.

Par exemple, si votre administrateur du forum s’appelle

CamilleAdmin

, ce nom ne doit pas être utilisé ici.

Nous sommes toujours en train de configurer la connexion à la base de données.

7. Indiquer le mot de passe SQL

Dans le champ :

Mot de passe

saisissez le mot de passe que vous avez choisi pour l’utilisateur SQL

phpbb_ecole

.

Ce n’est pas :

- le mot de passe de votre administrateur phpBB ;
- le mot de passe de votre messagerie ;
- un mot de passe fourni dans le cours.

C’est uniquement le mot de passe du compte MySQL ou MariaDB créé pour le forum.

8. Indiquer le nom de la base

Dans :

Nom de la base de données

saisissez le nom de la base créée dans la leçon 6.

Dans notre exemple :

phpbb_ecole

Le nom de la base et le nom de l’utilisateur sont identiques dans notre exemple, mais ils désignent toujours deux choses différentes.

Retenez :

phpbb_ecole comme base = endroit où seront enregistrées les données
phpbb_ecole comme utilisateur = compte autorisé à accéder à cet endroit

Si vous avez utilisé un autre nom de base, saisissez évidemment votre nom réel.

9. Comprendre le préfixe des tables

Le dernier champ important est :

Préfixe des tables

Nous allons conserver :

phpbb_

Qu’est-ce que cela signifie ?

Une base contient plusieurs tables.

Une table regroupe un type d’informations.

Par exemple, phpBB créera une table pour les utilisateurs.

Avec le préfixe

phpbb_

, cette table portera un nom comme :

phpbb_users

Une autre table pourra s’appeler :

phpbb_posts

Le préfixe est donc simplement un début commun ajouté aux noms des tables de phpBB.

Il ne remplace pas le nom de la base.

Nous avons donc :

Base : phpbb_ecole
Préfixe des tables : phpbb_

Ce sont deux informations différentes.

10. Relire le formulaire avant de l’envoyer

Avant de valider, reprenez les champs un par un.

Pour notre exemple local :

Type : MySQL avec l’extension MySQLi
Serveur : 127.0.0.1
Port : le port réel de votre MySQL ou MariaDB
Utilisateur : phpbb_ecole
Mot de passe : votre mot de passe SQL
Base : phpbb_ecole
Préfixe : phpbb_

Relisez particulièrement :

- le nom de la base ;
- le nom de l’utilisateur ;
- le mot de passe ;
- le port.

Puis activez :

Envoyer

11. Ce que phpBB vérifie maintenant

phpBB essaie de se connecter au serveur de bases de données avec les informations que vous venez de fournir.

S’il réussit, l’assistant passe à l’étape suivante.

Le résultat attendu est l’écran :

Configuration du serveur

Cela signifie que phpBB a pu utiliser les paramètres SQL fournis.

L’installation n’est pas encore terminée.

12. Si phpBB affiche « Accès refusé »

Un message contenant :

Access denied

ou :

Accès refusé

signifie généralement que le serveur a bien été contacté, mais qu’il refuse la connexion avec les informations fournies.

Vérifiez alors :

- le nom de l’utilisateur SQL ;
- le mot de passe SQL ;
- l’hôte autorisé pour cet utilisateur ;
- ses droits sur la base.

Ne changez pas le mot de passe de l’administrateur phpBB : ce compte n’intervient pas dans cette connexion.

13. Si phpBB ne trouve pas la base

Si le message indique que la base est inconnue ou introuvable, vérifiez :

- son nom exact ;
- que vous utilisez bien le bon serveur MySQL ou MariaDB ;
- que la base existe toujours dans phpMyAdmin.

Une base créée dans un serveur n’apparaît pas automatiquement dans un autre.

14. Si phpBB n’arrive pas à joindre le serveur

Si la connexion au serveur lui-même échoue, vérifiez :

- que MySQL ou MariaDB est démarré ;
- l’adresse

127.0.0.1

;
- le port utilisé.

Corrigez uniquement l’information qui pose problème, puis renvoyez le formulaire.

Ne supprimez pas la base et ne recommencez pas toute l’installation sans raison.

15. Arrêtez-vous à l’écran suivant

Lorsque phpBB affiche :

Configuration du serveur

arrêtez-vous.

Vous venez de relier correctement phpBB à sa base de données.

Dans la prochaine leçon, nous expliquerons les paramètres du serveur web et nous terminerons l’installation.

Avant de continuer

Vous devez maintenant comprendre la différence entre :

- le serveur de bases de données ;
- l’utilisateur SQL ;
- le mot de passe SQL ;
- la base de données ;
- le préfixe des tables.

Si vous êtes capable d’expliquer chacun de ces éléments avec vos propres mots, vous êtes prêt pour la suite.

Camille utilise MariaDB dans WampServer.

Dans phpMyAdmin, elle vérifie que son serveur utilise le port 3306.

Sa fiche contient :

Base : phpbb_ecole
Utilisateur SQL : phpbb_ecole
Hôte : 127.0.0.1
Port : 3306

Dans l’assistant phpBB, elle choisit :

MySQL avec l’extension MySQLi

Puis elle renseigne :

Serveur : 127.0.0.1
Port : 3306
Utilisateur : phpbb_ecole
Mot de passe : son mot de passe SQL
Base : phpbb_ecole
Préfixe : phpbb_

Elle active

Envoyer

.

L’écran

Configuration du serveur

apparaît.

Camille sait alors que phpBB a réussi à se connecter à sa base avec les informations fournies.

Reprenez l’écran

Configuration de la base de données

laissé ouvert à la fin de la leçon précédente.

1. Choisissez

MySQL avec l’extension MySQLi

.

2. Saisissez

127.0.0.1

comme serveur pour notre installation locale.

3. Vérifiez dans phpMyAdmin le port utilisé par votre serveur MySQL ou MariaDB, puis saisissez ce numéro.

4. Saisissez le nom de l’utilisateur SQL créé précédemment.

5. Saisissez son mot de passe SQL.

6. Saisissez le nom exact de la base créée pour le forum.

7. Conservez

phpbb_

comme préfixe des tables.

8. Relisez tous les champs, puis activez

Envoyer

.

9. Vérifiez que l’assistant affiche :

Configuration du serveur

10. Arrêtez-vous sur cette page.

Pour terminer, expliquez avec vos propres mots la différence entre le nom de la base et le préfixe des tables.

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

phpBB a besoin de plusieurs informations pour se connecter à MySQL ou MariaDB.

L’adresse

127.0.0.1

désigne notre ordinateur local.

Le port précise quel service de base de données doit être contacté.

L’utilisateur SQL et son mot de passe autorisent phpBB à accéder à la base.

Le nom de la base indique où phpBB doit travailler.

Le préfixe

phpbb_

est ajouté au début du nom des tables créées par phpBB.

L’utilisateur SQL et l’administrateur phpBB sont deux comptes différents.

Lorsque l’écran

Configuration du serveur

apparaît, la connexion à la base a été acceptée.