Activer le débug sur phpBB

[dcz]

Hello,

phpBB3 possède un puissant (très) système de débug qui permet d'afficher les éventuelles erreurs des script partageant son code et de contrôler la performance des requêtes SQL qu'il effectue.
Il y a deux niveaux de débug, pouvant tout deux être activés dans config.php.
Votre fichier config.php ressemble au départ à cela :

Code: Tout sélectionner

<?php
// phpBB 3.0.x auto-generated configuration file
// Do not change anything in this file!
$dbms = 'type_de_la_bdd';
$dbhost = 'domaine_ou_socket_pour_se_connecter_a_la_bdd';
$dbport = 'port_de_la_connection_au_serveur_de_bdd';
$dbname = 'nom_de_la_bdd';
$dbuser = 'utilisateur_de_la_bdd';
$dbpasswd = 'mot_de_passe_de_la_bdd';
$table_prefix = 'prefixe_des_tables_des_phpbb';
$acm_type = 'file';
$load_extensions = '';

@define('PHPBB_INSTALLED', true);
// @define('DEBUG', true);
// @define('DEBUG_EXTRA', true);
?>


Les lignes qui nous interessent ici sont :

Code: Tout sélectionner

// @define('DEBUG', true);
// @define('DEBUG_EXTRA', true);                

Le premier niveau de débug s'active en remplaçant :

Code: Tout sélectionner

// @define('DEBUG', true);                

par :

Code: Tout sélectionner

@define('DEBUG', true); 

Faire cela va activer l'affichage des erreurs, ajouter le temps de génération de page dans le footer et ajouter, pour les admins, un lien "explain", à la suite du temps de génération de page, permettant d'analyser la performance des requêtes effectuées sur la page en cours.

Le deuxième niveau ajoute simplement la RAM nécessaire à la génération de la page dans le footer et n'est actif que si le premier niveau est activé. Il active aussi l'affichage des éventuels erreur des fichiers de langue depuis phpBB3.0.5.
Pour l'activer, remplacez :

Code: Tout sélectionner

// @define('DEBUG_EXTRA', true);                

par :

Code: Tout sélectionner

@define('DEBUG_EXTRA', true); 

A noter qu'il est préférable de ne pas activer le débug sur un serveur de production, car l'affichage d'erreurs pourrait permettrait à des esprits malicieux de trouver des informations précieuse pour torturer votre forum (comme le chemin absolu de votre forum, ou plus simplement l'identification plus facile d'une erreur qui pourrait être exploitable pour hacker votre forum).

Mais il est en revanche vraiment préférable de l'activer sur vos serveur test / local pour vous assurer de ne pas louper d'erreur avant mise en production, d'autant plus lorsque vous installez des mods.