Installation et configuration de phpBB en local

Rédigé par: Fred
Rédigé le: 03 juil. 2023, 21:43
Vues: 241

Description: Installation du serveur de développement sur Widows, mac OS et Linux afin que vous puissiez utiliser phpBB sur une machine locale à des fins de test.

Catégories: Divers

Lien vers cet article: Tout sélectionner

[url=https://forums.caforum.fr/kb/viewarticle?a=32]Base de connaissance - Installation et configuration de phpBB en local[/url]
Cet article explique comment configurer un serveur Web de développement sur votre ordinateur local avec PHP, MariaDB et phpMyAdmin à l'aide du logiciel XAMPP. Bien que XAMPP soit disponible pour plusieurs systèmes d'exploitation et que certaines des instructions répertoriées ici soient applicables à ces systèmes d'exploitation, cet article est spécifiquement destiné aux systèmes Windows. Il a été écrit sur la base de XAMPP version 7.4.7 pour Windows, les versions plus récentes ou plus anciennes de XAMPP peuvent avoir des instructions légèrement différentes.

Remarques de préinstallation
  • XAMPP prend en charge les versions actuelles de Windows et certaines plus récentes, consultez la documentation sur la version que vous téléchargez pour la compatibilité. Les anciennes versions de XAMPP peuvent être téléchargées à partir de leurs archives si vous avez besoin d'assistance pour les anciennes versions de Windows.
  • XAMPP est livré avec MariaDB qui est compatible avec MySQL. Le package d'installation XAMPP et le panneau de configuration le répertorient comme MySQL. Pour les besoins de cet article, les noms MariaDB et MySQL sont interchangeables.
  • Si vous avez déjà installé un serveur Web ou un logiciel MySQL, veuillez le désinstaller ou le désactiver complètement avant de continuer afin d'éviter tout conflit.
  • Lors de l'accès à une URL https servie à partir de XAMPP, le certificat SSL par défaut utilisé par XAMPP ne sera pas valide et le navigateur émettra un avertissement concernant un certificat non valide. Votre navigateur devrait avoir une option pour faire une exception et vous pouvez le faire en toute sécurité dans ce cas.
Téléchargement de XAMPP

Les dernières versions de XAMPP peuvent être téléchargées à partir de leur page de téléchargement principale.

Vous devez sélectionner une version de XAMPP avec une version PHP supportée par votre version de phpBB. La numérotation des versions actuelles de XAMPP est basée sur les versions PHP qu'elles utilisent, par ex. XAMPP version 7.4.7 utilise PHP version 7.4.7. Si vous avez besoin d'assistance pour une ancienne version de PHP parce que vous avez une ancienne version de phpBB, les anciennes versions de XAMPP sont disponibles à partir de leurs archives.

Installation de XAMPP

Si vous avez téléchargé un fichier zip, décompressez-le et déplacez le dossier "xampp" à la racine du lecteur C. Ne placez pas dans les répertoires Windows car cela peut entraîner des problèmes d'autorisations. Recherchez le fichier xampp-control.exe dans le dossier xampp et exécutez-le pour démarrer XAMPP.

Si vous avez téléchargé le programme d'installation .EXE de XAMPP à partir de leur page de téléchargement principale, double-cliquez sur le fichier pour commencer l'installation. Confirmez que vous souhaitez exécuter le programme d'installation si des boîtes d'avertissement de sécurité apparaissent.
  • La boîte de dialogue d'installation de XAMMP vous présentera des options pour installer différents composants, la valeur par défaut est d'installer tous les composants et vous pouvez tous les installer en toute sécurité. Au minimum, vous devriez avoir sélectionné Apache, MySQL, PHP et phpMyAdmin. CLIQUEZ SUR SUIVANT>>
  • Ensuite, vous devez indiquer où vous souhaitez installer XAMPP. La valeur par défaut est C:\xampp et recommandée pour éviter les problèmes potentiels avec les autorisations Windows. CLIQUEZ SUR SUIVANT>>
  • Choisissez votre langue. CLIQUEZ SUR SUIVANT>>
  • La boîte de dialogue suivante contient des informations sur Bitnami qui peut être utilisé pour installer des applications Web telles que phpBB, Drupal et autres dans votre installation XAMPP. phpBB vous recommande de ne pas utiliser ces programmes d'installation pour phpBB. Généralement, ils peuvent installer une version obsolète de phpBB et parfois modifier l'installation. Si vous souhaitez poursuivre immédiatement l'installation de XAMPP, décochez "En savoir plus sur Bitnami pour XAMPP". CLIQUEZ SUR SUIVANT>>
  • Vous êtes maintenant dans la boîte de dialogue "Prêt à installer", cliquez à nouveau sur Suivant pour commencer l'installation de XAMPP.
XAMPP commencera à extraire tous les fichiers nécessaires et commencera l'installation. Selon la vitesse de votre ordinateur, cela prendra généralement quelques minutes.

À ce stade, une alerte du pare-feu Windows peut s'afficher. Pour des raisons de sécurité, cliquez sur Annuler pour ne pas l'autoriser à traverser le pare-feu. Notez que cela peut désactiver certaines fonctionnalités de phpBB qui nécessitent un accès à Internet, comme la vérification de version dans le panneau de contrôle d'administration de phpBB. La sécurité d'autoriser XAMPP à travers votre pare-feu n'entre pas dans le cadre de cette rubrique, consultez leur documentation.

Vous avez maintenant terminé l'installation, cliquez sur Terminer pour ouvrir le panneau de configuration de XAMPP.

Exécution de XAMPP

Dans le panneau de configuration de XAMPP, cliquez sur les boutons Démarrer à côté de "Apache" et "MySql". Vous n'avez pas besoin de démarrer d'autres services s'ils sont répertoriés. Lors du démarrage de MySQL, vous pouvez recevoir une autre invite du pare-feu Windows, sélectionnez à nouveau Annuler. "En cours d'exécution" doit apparaître à côté de chacun de ces services et le bouton "Démarrer" doit se transformer en "Arrêter".

Vous pouvez maintenant vérifier si cela fonctionne en visitant http://localhost/ avec votre navigateur Web. Vous devriez être accueilli par une page Web "Bienvenue dans XAMPP".

En option, vous pouvez configurer Apache et MySQL pour qu'ils démarrent automatiquement au démarrage du panneau de configuration de XAMPP. Cliquez sur le bouton "Config" en haut à droite, cochez Apache et MySQL dans la section pour le démarrage et l'enregistrement automatiques. La prochaine fois que vous démarrerez XAMPP, ils démarreront automatiquement.

Configuration de l'utilisateur et de la base de données MySQL

Ensuite, nous devons configurer un nouvel utilisateur MySQL et une nouvelle base de données que phpBB utilisera à l'aide de phpMyAdmin. À côté de l'option "MySql" dans le panneau de configuration de XAMPP, cliquez sur le bouton "Admin". Votre navigateur par défaut ouvrira phpMyAdmin, vous pouvez éventuellement l'ouvrir dans un navigateur Web sans le panneau de contrôle de XAMPP en utilisant http://localhost/phpmyadmin/.

phpMyAdmin est une application Web très populaire pour administrer MySQL. Il est également disponible dans votre panneau de contrôle d'hébergement pour un site Web en direct sur presque n'importe quel hôte. Si vous allez utiliser une base de données/des fichiers phpBB existants ou si vous avez des informations d'identification de base de données fournies par votre hébergeur, vous pouvez simplifier les choses en les utilisant ici. Pour un forum phpBB existant, ils peuvent être trouvés dans le fichier config.php de phpBB. Vous auriez besoin de contacter votre hôte pour le site Web en direct.

Vous pouvez utiliser n'importe quelles informations d'identification ici, mais si, par exemple, votre hôte Web en direct vous fournit des informations d'identification différentes, config.php devra être modifié avant de le télécharger sur l'hôte Web en direct.

Dans le menu supérieur de phpMyAdmin, cliquez sur l'onglet "Comptes d'utilisateurs" puis cliquez sur le lien "Ajouter un nouvel utilisateur" un peu en bas de la page à gauche.
  • Entrez un nom d'utilisateur".
  • Pour "Nom d'hôte", laissez par défaut "Tout hôte".
  • Entrer un mot de passe.
  • Si vous souhaitez créer une base de données avec le même nom que le nom d'utilisateur que vous avez entré, cochez la case.
  • côté de Privilèges globaux, cochez "Tout cocher".
  • Tout en bas, cliquez sur le bouton Aller.
Vous devriez être présenté avec un écran de confirmation que vous avez créé avec succès un nouvel utilisateur.

Si vous n'avez pas créé de base de données à l'étape précédente, nous devons ensuite en créer une, cliquez sur l'onglet Bases de données en haut de phpMyAdmin.
  • Sous "Créer une nouvelle base de données", entrez un nom pour la base de données.
  • Dans la liste déroulante, sélectionnez "utf8_bin".
  • Cliquez sur "Créer".
Vous devriez recevoir une confirmation que la base de données a été créée et vous êtes maintenant prêt à installer phpBB.

Dossier htdocs de XAMPP

En supposant que vous avez installé XAMPP dans C:\xampp, à l'aide de l'explorateur de fichiers Windows, ouvrez le dossier C:\xampp\htdocs. Ce dossier est l'équivalent de html_docs ou d'un dossier portant le même nom sur un serveur Web en direct. Lorsque vous ouvrez http://localhost/ dans votre navigateur, il s'agit du répertoire racine utilisé pour servir les fichiers.

Les fichiers et dossiers du dossier htdocs de XAMPP ne sont que des exemples de fichiers et peuvent être supprimés en toute sécurité à ce stade. Si vous ne voulez pas les supprimer, déplacez-les ailleurs.

Utiliser une installation existante de phpBB avec XAMPP

Si vous utilisez une base de données phpBB existante et des fichiers copiés à partir d'un site Web en direct, il est préférable de suivre la structure de répertoire existante. Si le forum en direct est installé dans example.com/forum/, créez un dossier dans htdocs nommé "forum", puis copiez-y vos fichiers et dossiers phpBB existants. Vous devrez également importer vos données phpBB existantes dans MySQL. Une fois que vous avez terminé les deux opérations, vous devriez pouvoir accéder à votre forum local à http://localhost/, http://localhost/forum/ ou à tout autre répertoire dans lequel vous avez copié les fichiers.

Nouvelle installation de phpBB avec XAMPP

Pour une nouvelle installation de phpBB, téléchargez la dernière version de phpBB, décompressez le téléchargement et vous devriez avoir un dossier appelé phpBB3 qui contient de nombreux fichiers et dossiers. Si vous souhaitez accéder à votre forum depuis http://localhost/ copiez tout le contenu du dossier phpBB3 dans htdocs. Si à la place vous vouliez y accéder depuis http://localhost/forum/, créez un nouveau dossier dans htdocs appelé forum et copiez-y tout le contenu du dossier phpBB3.

Ensuite, ouvrez http://localhost/install/ avec votre navigateur ou Si vous avez copié les fichiers dans un sous-dossier, pointez le navigateur là-bas, par exemple. http://localhost/forum/install/.

Lorsqu'on vous demande les informations de la base de données, utilisez le nom de la base de données, le nom d'utilisateur et le mot de passe que nous avons créés dans les étapes ci-dessus. Une fois l'installation de phpBB terminée, supprimez le dossier d'installation dans votre répertoire phpBB. Vous devriez maintenant pouvoir accéder au forum.

Notez que si vous suivez un guide d'installation ici sur sur le forum, les instructions pour définir les autorisations de fichiers et de dossiers n'ont pas à être suivies. Cependant, si vous téléchargez ces fichiers sur le serveur en direct, leurs autorisations devront être modifiées sur le serveur en direct.

Paramètres php.ini (facultatif)

Un problème que vous pouvez rencontrer à la fois avec XAMPP et un serveur en direct est les limitations définies dans le php.ini pour la taille des fichiers, le temps d'exécution du script, etc. L'importation d'une grande base de données à l'aide de phpMyAdmin, par exemple, peut échouer en raison de la taille du fichier ou de la durée. prend. Bien que ces limitations soient importantes pour un serveur en direct, elles peuvent être très élevées sur un serveur local. Dans le panneau de configuration de XAMPP à côté de "Apache", cliquez sur le bouton "Config" et sélectionnez "PHP". Cela ouvrira le fichier php.ini dans votre éditeur de texte par défaut. Recherchez les valeurs suivantes et modifiez-les. Exemples de valeurs supérieures :

Code: Tout sélectionner

upload_max_filesize = 999M
post_max_size = 999M
memory_limit = 1024M
max_execution_time = 999
Une fois ces valeurs modifiées, enregistrez le fichier. Dans le panneau de configuration de XAMPP, cliquez sur Arrêter à côté de "Apache", puis cliquez sur Démarrer.

Invite de commande (facultatif)

Le bouton marqué "Shell" dans le panneau de configuration de XAMPP ouvre une invite de commande, des commandes de type Unix peuvent être émises à partir de cette invite de commande. Cela peut être particulièrement utile pour importer et exporter de grandes bases de données. Il peut également être utilisé pour envoyer des commandes à la CLI de phpBB.

Fichier hôte Windows (facultatif)

phpBB est suffisamment "intelligent" pour que les liens qu'il génère utilisent http://localhost/ mais ce n'est pas idéal. Vous pouvez diriger les demandes de votre domaine vers XAMPP en modifiant le fichier hôte Windows. Ouvrez C:\Windows\System32\drivers\etc\hosts. Ajoutez ces lignes à la fin du fichier :

Code: Tout sélectionner

127.0.0.1 yourdomain.com
127.0.0.1 www.yourdomain.com
Enregistrez le fichier, vous pouvez être invité par Windows pour les privilèges administratifs pour enregistrer le fichier. Une fois enregistré, vous devriez pouvoir accéder à l'installation locale dans XAMPP lorsque vous utilisez votre navigateur pour ouvrir l'URL yourdomain.com. Cependant, les problèmes de cache et de DNS peuvent être un problème. Fermez au minimum le navigateur, rouvrez-le et effacez le cache du navigateur. D'autres étapes peuvent être nécessaires, recherchez sur le Web d'autres options. Certains navigateurs ont des extensions spécifiquement pour cela.

Pour revenir au domaine actif, ouvrez à nouveau C:\Windows\System32\drivers\etc\hosts et ajoutez un signe dièse au début des lignes :

Code: Tout sélectionner

#127.0.0.1 yourdomain.com
#127.0.0.1 www.yourdomain.com
Enregistrez le fichier, encore une fois, vous devrez peut-être vider le cache de votre navigateur et prendre d'autres mesures.

Installations multiples de XAMPP (facultatif)

Si, par exemple, vous souhaitez que plusieurs versions de PHP soient disponibles, vous pouvez le faire de différentes manières. Le moyen le plus simple est d'avoir plusieurs copies de XAMPP. Lorsque vous installez ou copiez différentes versions de XAMPP au lieu du nom de dossier par défaut, utilisez-en un basé sur sa version, s'il s'agit de la version XAMPP 7.4.7, nommez le dossier xampp747. Trouvez le fichier exécutable xampp-control.exe et créez un raccourci vers celui-ci pour démarrer XAMPP. Assurez-vous de nommer le raccourci de manière appropriée.

Notez que même si vous pouvez avoir plusieurs copies de XAMPP sur un système, vous ne pouvez pas les exécuter simultanément.