PhpBB Lab Académie

Télécharger le pack complet de phpBB 3.3.17, comprendre ce qu’est une archive ZIP, préparer un dossier réservé au forum dans WampServer, y placer correctement les fichiers de phpBB et vérifier que l’assistant d’installation est accessible.

Ce que nous allons faire

Votre environnement local est maintenant prêt.

Vous avez :

- WampServer en fonctionnement ;
- une base de données réservée au forum ;
- un utilisateur SQL autorisé à accéder à cette base.

Il manque encore le principal : les fichiers de phpBB.

Dans cette leçon, nous allons télécharger phpBB, extraire son archive ZIP, créer le dossier qui accueillera notre forum et y copier les fichiers du logiciel.

Nous n’allons pas encore installer phpBB. À la fin de la leçon, nous vérifierons seulement que l’assistant d’installation s’ouvre correctement.

1. Comprendre ce que vous téléchargez

Un logiciel comme phpBB est composé de nombreux fichiers et dossiers.

Pour faciliter son téléchargement, ces fichiers sont regroupés dans une archive ZIP.

Une archive ZIP est simplement un fichier qui contient d’autres fichiers.

Vous pouvez l’imaginer comme une boîte fermée :

Archive ZIP
    -> fichiers de phpBB
    -> dossiers de phpBB
    -> ressources nécessaires au logiciel

Tant que les fichiers restent dans cette archive, ils ne sont pas placés dans le dossier de votre futur forum.

Nous devons donc d’abord extraire l’archive. Extraire signifie récupérer son contenu sous forme de fichiers et de dossiers ordinaires.

2. Utiliser le pack complet de phpBB

Pour créer un nouveau forum, nous avons besoin du pack complet de phpBB.

Le pack complet contient tous les fichiers nécessaires à une nouvelle installation.

Il existe aussi des fichiers destinés à mettre à jour un forum déjà installé. Ils ne conviennent pas pour notre première installation.

Dans ce cours, nous travaillons avec :

phpBB 3.3.17

et avec l’interface française prévue pour le parcours.

Si vous disposez déjà du pack complet français de phpBB 3.3.17 fourni pour ce cours, utilisez-le. Il n’est pas nécessaire de le télécharger une seconde fois.

Sinon, utilisez une source de confiance pour récupérer le pack correspondant exactement à cette version.

La page internationale de phpBB se trouve ici :

Téléchargements de phpBB

La communauté francophone phpBB-fr est accessible ici :

phpBB-fr

Pour suivre ce cours sans différences dans les intitulés des écrans, utilisez bien la version française prévue pour le parcours.

3. Extraire l’archive ZIP

Repérez le fichier ZIP de phpBB dans l’Explorateur de fichiers Windows.

Il peut par exemple se trouver dans votre dossier Téléchargements.

Sélectionnez l’archive, ouvrez son menu contextuel, puis choisissez :

Extraire tout

Vous pouvez ouvrir le menu contextuel avec la touche prévue à cet effet sur votre clavier ou avec :

Majuscule + F10

Choisissez un dossier de travail facile à retrouver, puis lancez l’extraction.

Une fois l’opération terminée, ouvrez le dossier extrait.

Selon le paquet utilisé, vous pouvez voir un dossier intermédiaire appelé par exemple :

phpBB3

Ouvrez-le.

Vous devez arriver à un niveau où se trouvent directement plusieurs éléments de phpBB, notamment :

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

Vous n’avez pas besoin de comprendre le rôle de tous ces fichiers maintenant.

Ce qui compte est de repérer le dossier qui contient directement index.php. C’est le contenu de ce dossier que nous allons copier.

4. Comprendre le dossier www de WampServer

Dans notre installation, WampServer utilise ce dossier pour les sites locaux :

C:\wamp64\www

Le dossier

www

est l’emplacement dans lequel nous pouvons créer les dossiers de nos sites locaux.

Par exemple :

C:\wamp64\www\mon-site

pourrait être accessible dans le navigateur avec une adresse locale ressemblant à :

http://localhost/mon-site/

Nous allons utiliser exactement le même principe pour notre forum.

5. Créer le dossier du forum

Dans l’Explorateur de fichiers, ouvrez :

C:\wamp64\www

Créez un nouveau dossier nommé :

forum-ecole

Notre futur forum se trouvera donc ici :

C:\wamp64\www\forum-ecole

Ce dossier doit être réservé à l’exercice.

S’il existe déjà et contient un autre projet, ne supprimez rien et ne copiez pas phpBB par-dessus. Créez plutôt un autre dossier vide et utilisez son nom pour la suite du cours.

6. Copier les fichiers de phpBB

Revenez dans le dossier extrait de phpBB.

Placez-vous au niveau où se trouve directement le fichier :

index.php

Sélectionnez tout le contenu de ce dossier : les fichiers et les sous-dossiers.

Copiez-les avec :

Ctrl + C

Ouvrez ensuite :

C:\wamp64\www\forum-ecole

Puis collez le contenu avec :

Ctrl + V

Attendez la fin de la copie.

7. Vérifier que les fichiers sont au bon niveau

Cette vérification est importante.

Après la copie, ce fichier doit exister directement ici :

C:\wamp64\www\forum-ecole\index.php

Et le programme d’installation doit se trouver ici :

C:\wamp64\www\forum-ecole\install\app.php

Si vous obtenez plutôt :

C:\wamp64\www\forum-ecole\phpBB3\index.php

cela signifie que vous avez copié le dossier

phpBB3

lui-même au lieu de copier son contenu.

Dans ce cas, si

forum-ecole

a été créé uniquement pour cet exercice et ne contient rien d’autre, déplacez le contenu de

phpBB3

directement dans

forum-ecole

.

Le résultat attendu est toujours :

forum-ecole
    -> index.php
    -> config.php
    -> adm
    -> includes
    -> install
    -> language
    -> phpbb
    -> styles
    -> vendor
    -> ...

8. Pourquoi ne faut-il pas supprimer le dossier install maintenant ?

Vous voyez dans les fichiers un dossier nommé :

install

Ce dossier contient l’assistant qui va nous guider pendant l’installation de phpBB.

Nous en avons donc encore besoin.

Ne le supprimez pas maintenant.

Il sera retiré seulement après la réussite de l’installation, dans une leçon suivante.

9. Vérifier que l’assistant est accessible

Démarrez WampServer si ce n’est pas déjà fait.

Ouvrez votre navigateur et saisissez dans la barre d’adresse :

http://localhost/forum-ecole/install/

Puis validez.

Le résultat attendu est l’affichage de l’assistant d’installation de phpBB.

À ce stade, arrêtez-vous sur cette page.

Ne remplissez encore aucun formulaire.

Cette vérification nous apprend simplement que :

- WampServer fonctionne ;
- le dossier

forum-ecole

est accessible ;
- les fichiers de phpBB sont placés au bon endroit ;
- le programme d’installation peut être ouvert.

10. Si l’assistant ne s’affiche pas

Ne recommencez pas toute l’installation de WampServer.

Commencez par vérifier trois choses simples.

Première vérification : WampServer fonctionne-t-il ?

Ouvrez :

http://localhost/

Si cette page ne fonctionne plus, le problème concerne d’abord l’environnement local.

Deuxième vérification : le dossier porte-t-il le bon nom ?

Vérifiez que vous avez bien :

C:\wamp64\www\forum-ecole

Troisième vérification : app.php est-il au bon endroit ?

Vérifiez la présence de :

C:\wamp64\www\forum-ecole\install\app.php

Si ce fichier se trouve dans un dossier supplémentaire comme

phpBB3

, revenez à l’étape consacrée au niveau des fichiers.

Avant de passer à la leçon suivante

Vous devez maintenant avoir :

- le pack complet de phpBB 3.3.17 extrait ;
- un dossier

forum-ecole

dans

C:\wamp64\www

;
- les fichiers de phpBB directement dans ce dossier ;
- le dossier

install

toujours présent ;
- l’assistant d’installation visible dans votre navigateur.

Dans la prochaine leçon, nous allons commencer l’installation proprement dite et créer votre compte administrateur phpBB.

Camille télécharge le pack complet de phpBB 3.3.17 et l’extrait dans son dossier Téléchargements.

Dans le dossier extrait, elle ouvre

phpBB3

et y trouve directement

index.php

.

Elle crée ensuite :

C:\wamp64\www\forum-ecole

Elle sélectionne tout le contenu du dossier

phpBB3

, le copie et le colle dans

forum-ecole

.

Elle vérifie ensuite :

C:\wamp64\www\forum-ecole\index.php

puis :

C:\wamp64\www\forum-ecole\install\app.php

Les deux fichiers existent.

Enfin, elle ouvre :

http://localhost/forum-ecole/install/

L’assistant d’installation apparaît.

Camille s’arrête là. Les fichiers sont prêts, mais phpBB n’est pas encore installé.

Préparez maintenant les fichiers de votre forum.

1. Repérez le pack complet de phpBB 3.3.17 prévu pour le cours.

2. Extrayez son archive ZIP dans un dossier de travail.

3. Dans le dossier extrait, repérez le niveau où

index.php

apparaît directement.

4. Ouvrez

C:\wamp64\www

et créez un dossier vide nommé

forum-ecole

.

5. Copiez tous les fichiers et sous-dossiers de phpBB dans

forum-ecole

.

6. Vérifiez la présence de :

C:\wamp64\www\forum-ecole\index.php

et :

C:\wamp64\www\forum-ecole\install\app.php

7. Ouvrez dans votre navigateur :

http://localhost/forum-ecole/install/

8. Vérifiez que l’assistant d’installation s’affiche, puis arrêtez-vous sur cette page.

Ne supprimez pas le dossier

install

et ne remplissez pas encore les formulaires de l’assistant.

Le pack complet de phpBB contient tous les fichiers nécessaires à une nouvelle installation.

Une archive ZIP doit être extraite avant de pouvoir utiliser normalement son contenu.

Avec notre installation WampServer, le forum est placé dans :

C:\wamp64\www\forum-ecole

Le fichier

index.php

doit se trouver directement dans ce dossier.

Le dossier

install

contient l’assistant d’installation et doit encore être conservé.

L’adresse :

http://localhost/forum-ecole/install/

permet de vérifier que l’assistant est accessible.

Nous commencerons réellement l’installation de phpBB dans la prochaine leçon.