CAForum-phpBB

Lien vers cet article: Tout sélectionner

[url=https://forums.caforum.fr/kb/viewarticle?a=36]Base de connaissance - Gérer les extensions sur phpBB[/url]

Aperçu

Introduction
Où les extensions doivent-elles être téléchargées sur le serveur web ?
Où les extensions sont-elles gérées dans le PCA ?
Ce qu’il faut éviter :
Que se passe-t-il lors de l'« activation », de la « désactivation » et de la « suppression des données » ?
Extensions validées et non validées

1. Introduction

Cet article est destiné à fournir des informations générales sur les extensions ainsi que sur les fonctionnalités moins connues des extensions et du PCA (Panneau de configuration de l’administrateur).

2. Où les extensions doivent-elles être téléchargées sur le serveur web ?

Toutes les extensions doivent être stockées sur le serveur web dans le dossier ./ext de phpBB. Pour chaque extension, le modèle de chemin est ./ext/<autor-name>/<extension-name>/. Si une extension n’est pas conforme à ce modèle de chemin, phpBB ne verra pas cette extension et l’administrateur ne pourra pas l’activer.

3. Où les extensions sont-elles gérées dans le PCA ?

Toutes les extensions sont gérées dans l’onglet PERSONNALISER (Gérer les extensions). Toutes les extensions disponibles sur le serveur web y sont listées avec leurs numéros de version. Sur cette page, une extension peut être installée, désactivée/réactivée et désinstallée. En cliquant sur « Détails » d’une extension, vous ouvrez une page d’information où vous pouvez en savoir plus sur l’objectif de l’extension, ses exigences et le nom du ou des auteurs. De plus, une vérification de version est automatiquement déclenchée sur cette page d’informations, si l’auteur de l’extension en a configuré une. Si la prorogation a été approuvée par la CDB (Base de données de personnalisation), il y a certainement une vérification de version.

Au bas de la page PERSONNALISER (Gérer les extensions), vous trouverez également tous les guides rapides sur la façon d’INSTALLER, METTRE À JOUR et SUPPRIMER. Il est également recommandé de suivre les instructions d’installation des auteurs de l’extension si des fonctionnalités spéciales doivent être prises en compte.

4. Ce qu’il faut éviter

Les extensions sont assez faciles à gérer. Mais il y a certaines choses que vous devriez éviter, au risque de planter votre forum phpBB.

Supprimer une extension installée du serveur web : une extension déjà installée et activée ne doit pas être supprimée du serveur web via le client FTP si elle n’est plus nécessaire. Selon le fonctionnement de l’extension, cela peut entraîner l’arrêt du forum. Cela signifie que le frontend n’est plus accessible aux utilisateurs et que l’administrateur ne peut plus accéder au PCA. Une désinstallation régulière ne serait alors pas non plus possible, car les fichiers nécessaires ont été supprimés. Même une extension déjà installée mais désactivée ne doit pas être supprimée via le client FTP, car alors un message d’erreur apparaîtra dans la liste des extensions, au moins sur la page PERSONNALISER (Gérer les extensions), puisque l’extension est toujours enregistrée dans la base de données comme installée. Si une extension a été supprimée accidentellement sans la désinstaller au préalable, elle peut simplement être téléchargée sur le serveur Web. Il faut veiller à ce que la même version de l’extension soit téléchargée à nouveau si possible. Ensuite, l’extension peut être désinstallée régulièrement.
Mettre à jour une extension activée : Pour mettre à jour une extension, il est important de la désactiver d’abord et de la réactiver après la mise à jour. La mise à jour via le client FTP lorsqu’il est activé n’est pas suffisante, car certains mécanismes de phpBB ne peuvent pas être exécutés. Il s’agit, par exemple, de la migration (expliquée plus loin) et des actions spécifiques à l’extension lors de la désactivation/activation. Cela peut signifier que dans le cas le plus inoffensif, l’extension ne fait pas ou n’affiche pas ce qu’elle est censée faire et dans le pire des cas, des dysfonctionnements peuvent survenir avec l’extension et/ou phpBB. Si l’extension propose une option alternative pour la désactiver dans ses paramètres, cette option n’est pas non plus suffisante. Pour qu’une extension soit mise à jour, elle doit toujours être désactivée sur la page PERSONNALISER (Gérer les extensions). Si vous avez oublié de désactiver une extension avant la mise à jour, celle-ci doit être désactivée après la mise à jour, puis réactivée. Idéalement, les étapes manquantes sont rattrapées. Cependant, il n’est pas garanti que cela fonctionnera toujours.
Écraser une extension lors de la mise à jour : une extension ne doit pas être écrasée lors de la mise à jour, mais doit d’abord être complètement supprimée du serveur Web après la désactivation. La raison en est que la mise à jour peut supprimer les fichiers (et dossiers) obsolètes qui ne sont plus importants dans la nouvelle version de l’extension. Si, en revanche, le serveur Web est seulement écrasé, il y a un risque que des fichiers obsolètes restent. Et ces fichiers peuvent alors provoquer des dysfonctionnements dans certaines circonstances. Cela affecte principalement les fichiers du système de modèles. Si des modifications ont été apportées à une extension, par exemple aux fichiers de langue ou aux modèles, ces modifications doivent bien sûr être enregistrées avant de mettre à jour l’extension, si vous ne l’avez pas déjà fait. Ensuite, les modifications peuvent être réinsérées après la mise à jour.
Désactiver toutes les extensions via une intervention dans la base de données ou une boîte à outils d’assistance : une intervention de la base de données pour désactiver une ou toutes les extensions et la fonction correspondante dans le STK ont une chose en commun : les extensions ne sont pas désactivées correctement, mais seulement marquées comme désactivées. Cependant, il existe un certain nombre d’extensions qui ne tolèrent pas bien une telle méthode de désactivation. Si une telle extension est pratiquement paralysée de force par l’intervention de DB ou STK, cela peut entraîner l’inaccessibilité de l’interface du forum, selon l’extension et la situation. En outre, cela peut également entraîner le blocage du STK lui-même. C’est pourquoi les interventions de base de données et le STK pour désactiver les extensions ne devraient jamais être la première option. Si vous avez accès au PCA et que toutes les extensions doivent être désactivées correctement en une seule fois, vous pouvez utiliser une de ces extensions Extension Manager Plus ou Enable/disable extensions completely ou Disable all Extensions. Si l’accès au PCA n’est plus possible, alors la première chose à essayer est d’utiliser le script d’urgence de david63. Voir le dernier point « En utilisant le script Désactiver les extensions » lire ici : Base de connaissance - Désactiver toutes les extensions à la fois. Important : Après l’exécution du script, le cache phpBB doit être supprimé manuellement. La cause technique des problèmes de désactivation par l’intervention de la base de données ou STK est ext.php, qui est requis par certaines extensions si la méthode disable_step() a été définie. Page associée de la documentation du développeur : Utilisation des commandes d’installation dans ext.php

5. Que se passe-t-il lorsque vous « activez », « désactivez » et « supprimez les données »

Ces fonctions font chacune beaucoup plus que vous ne le pensez au premier abord. Par conséquent, des informations supplémentaires énumérées ici peuvent aider à mieux comprendre à la fois les guides de référence rapide dans le PCA et le point « Ce qu’il faut éviter ».

Activer

Lorsqu’une extension est activée pour la première fois, phpBB installe en fait cette extension. C’est-à-dire que phpBB enregistre cette extension dans la base de données. En outre, un processus de mise à jour local de l’extension est également mis en mouvement lorsqu’elle est activée pour la première fois, ce que l’on appelle la migration. S’il y en a une, toutes les extensions n’ont pas besoin d’une migration. À l’aide de la migration, l’auteur de l’extension peut apporter des modifications à la base de données, par exemple, ou ajouter de nouveaux paramètres et modules PCA. La migration n’est pas seulement effectuée lors de l’activation initiale, mais peut également être effectuée lors d’une mise à jour de l’extension si l’auteur de l’extension a ajouté de nouveaux fichiers de migration.

Toutes les étapes de migration existantes sont automatiquement exécutées dans l’ordre. Par exemple, si vous installez une extension avec la version 1.0.2 pour la première fois et que l’auteur de l’extension a également ajouté une nouvelle migration à chaque nouvelle version, les étapes de migration 1.0.0, 1.0.1 et 1.0.2 seront automatiquement exécutées l’une après l’autre. Chaque étape de migration est notée comme terminée dans la base de données. Cela signifie que phpBB sait quelles étapes de migration ont déjà été effectuées lors de la prochaine activation de l’extension - par exemple après une mise à jour.

De plus, des actions spéciales peuvent également être effectuées pour chaque activation, que l’auteur de l’extension a également définies pour « Activer ». Toutes ces choses se passent en arrière-plan, l’administrateur ne remarque rien lorsqu’il clique sur « Activer ». Il se passe donc beaucoup plus que la simple activation d’une extension.
Lorsqu’une extension est activée pour la première fois, elle est installée et enregistrée à différents endroits de la base de données. Désactiver

Des trois fonctions mentionnées, celle-ci reste la plus simple. Ici, l’extension de phpBB est correctement désactivée et marquée comme inactive. Si une extension a été désactivée, phpBB se comporte comme si cette extension n’existait pas du tout. Tous les paramètres et données de l’extension sont conservés et sont immédiatement disponibles à nouveau lorsqu’ils sont réactivés.

De même, des actions spéciales peuvent être effectuées lors de la désactivation de l’extension, que l’auteur de l’extension a également définie pour « Désactiver ».
L’état « Désactivé » est une condition préalable importante pour qu’une extension se mette à jour correctement. Supprimer les données

Il s’agit d’une fonction souvent mal comprise et le nom de cette fonction n’explique que partiellement ce qui se passe réellement. La fonction principale est de désinstaller correctement une extension et de supprimer toutes les données d’une extension. Si l’extension a une migration, toutes les étapes de migration sont traitées à rebours dans l’ordre lors de la désinstallation. Les entrées de migration associées dans la base de données sont également supprimées.

Les données d’une extension comprennent, entre autres, les paramètres et ses modules PCA, si elle offre de tels paramètres. Ces données comprennent également toutes les données nécessaires au fonctionnement de l’extension. L’existence de telles données dépend de l’extension. phpBB finira par supprimer l’enregistrement de l’extension de la base de données.

Cette fonctionnalité ne supprime pas l’extension du serveur Web. L’extension peut donc être réinstallée immédiatement après une désinstallation. Cette fonction peut également être utilisée pour effectuer des actions spéciales que l’auteur de l’extension a également définies pour « Supprimer les données ».
Cette fonctionnalité désinstalle efficacement une extension. Si une extension doit seulement être mise à jour, cette fonction n’est pas nécessaire et n’est pas destinée à elle. À moins que l’auteur de l’extension ne donne des instructions explicites dans ce sens lors de la mise à jour de son extension. Cache

Intéressant à savoir : avec les trois fonctions, le cache du forum est également automatiquement supprimé. Ainsi, lorsqu’une extension est activée, désactivée ou désinstallée, il n’est pas nécessaire de vider manuellement le cache avant ou après.

6. Extensions validées et non validées

Avant d’expliquer pourquoi les deux types existent, il est important de comprendre ce que sont les extensions validées en premier lieu. Sur phpBB.com il y a la Base de données de personnalisation (abrégé : CDB). Cette base de données propose des extensions et des styles qui ont passé avec succès un processus de validation. Cet audit déterminera, entre autres, si les exigences officielles ont été respectées. Dans le cas des extensions, la qualité, la stabilité et la sécurité du code sont également vérifiées. Les validateurs s’assurent ainsi virtuellement qu’une extension se comporte correctement et est propre. C’est donc une bonne chose pour les utilisateurs finaux des extensions, car tout le monde bénéficie d’extensions et de styles validés.

Cependant, une telle vérification signifie une quantité de travail supplémentaire non négligeable pour un auteur d’extension. C’est particulièrement vrai pour les validateurs, qui doivent prendre en compte beaucoup de choses. C’est pourquoi la validation peut rapidement s’éterniser, car de nombreuses extensions et styles doivent être constamment vérifiés dans la CDB. Quelques semaines ou mois passent rapidement avant qu’une nouvelle extension ou une mise à jour d’une extension ne soit officiellement publiée. Si l’extension est publiée ; Les statistiques montrent qu’une grande partie n’obtient pas d’approbation et qu’un certain nombre d’auteurs abandonnent ensuite la validation.

Les exigences pour un auteur d’extension sont élevées et une solide connaissance de base dans de nombreux domaines et la volonté d’acquérir les connaissances manquantes sont requises. De plus, l’anglais peut également être un problème pour un auteur d’extension, car l’ensemble du processus de révision est mené en anglais. Ensuite, il y a les extensions payantes qui ne sont pas proposées dans la CDB pour diverses raisons et ne sont donc pas officiellement validées.

De plus, sur phpBB.com il y a une différence significative dans la gestion des extensions publiées dans le forum de développement d'extensions. Les extensions ne peuvent être publiées sur le forum que si l’auteur montre une volonté de soumettre l’extension pour validation après un développement réussi et les commentaires des utilisateurs. Si ce n’est pas le cas, une telle présentation d’extension peut être bloquée ou supprimée.

Pour les extensions qui n’ont pas été obtenues auprès de la CDB, la prudence est de mise, en particulier avec des auteurs d'extensions inconnus. Dans ce cas, il serait conseillé de tester d’abord une nouvelle extension dans un environnement de serveur web local approprié tel que WampServer.

WampServer

wampserver.com (site officiel)
wampserver.aviatechno.net (Packages d’installation et mises à jour)