Date de publication: le mardi 17 mai 2011 à 09h26
Dernière modification: par Pascal BOYER le mardi 17 mai 2011 à 09h33
« Article précédent: eZ Publish : configurer le moteur de recherche
» Article suivant: eZ Publish : gestion des URI (supprimer index.php et le siteaccess)

Le système de débuggage de eZ Publish permet d'afficher, pour un siteaccess donné (public ou d'administration), des informations précieuses au développeur, comme par exemple:

• Nombre de requêtes MySQL,
• Noms des templates utilisés
• Nombre de templates utilisés
• Temps de chargement des templates
• Des messages d'erreur
• etc...

Le fait d'accéder au nom des templates utilisés par le système pour chacun des objet affichés est une fonction particulièrement efficace pour découvrir le fonctionnement de eZ Publish. En effet, cela permet de rapidement identifier le ou les templates par défaut contenant le code relatif à telle ou telle fonction.

Après l'installation de eZ Publish

Une fois l'installation de eZ Publish terminée, il est nécessaire de modifier le fichier de configuration de surcharge suivant:

settings/override/site.ini.append.php

Les lignes à supprimer sont les suivantes:

[DebugSettings]
DebugOutput=disabled
DebugRedirection=disabled
 
[TemplateSettings]
Debug=disabled
ShowXHTMLCode=disabled
ShowUsedTemplates=disabled
 
[DatabaseSettings]
SQLOutput=disabled

Si on ne procède pas à leur suppression, c'est alors les options de débuggage du siteaccess Global (override) qu'il faut configurer à partir de l'outil « Configuration rapide».

Personnellement, je préfère configurer directement les options de débuggage du siteaccesss considéré.

Afficher les templates utilisés

Pour n'afficher, mêlés au contenu, que les templates utilisés par le système, les options à cocher sont:

:
Préalablement au choix des options de débuggage, il faut comment par sélectionner le siteaccess considéré dans la boite de dialogue «Siteaccess» puis valider son choix en cliquant sur Set.
De même, il faut valider les options de débuggage avec le bouton Set.

Option Template debug

L'option «Template debug» sert à positionner le paramètre Debug de la section [TemplateSettings] du fichier de surcharge site.ini.append.php à:

enabled

Cette option seule ne produit aucun affichage particulier et ne sert qu'à activer le système de débuggage. Elle est donc nécessaire mais non suffisante.

Option Inline template debug

L'option «Inline template debug» positionne le paramètre ShowXHTMLCode de la section [TemplateSettings] du fichier de surcharge site.ini.append.php à:

enabled

Dés lors, et après avoir vider les caches, les templates utilisés par le système s'affichent sur le site public:

Option Deb ug output

L'option «Debug output» positionne le paramètre DebugOutput de la section [DebugSettings] du fichier de surcharge site.ini.append.php à:

enabled

Cette option seule produit l'affichage particulier suivant:

Option List of used templates

L'option «List of used templates» positionne le paramètre ShowUsedTemplates de la section [TemplateSettings] du fichier de surcharge site.ini.append.php à:

enabled

Cette option seule ne produit aucun affichage particulier et doit être activée en même temps que la précédente option « Debug output».

L'affichage de débuggage est alors complété, au bas du tableau illustré par la figure ci-dessus, par les lignes complémentaires suivantes:

Le paramètre DebugByIp

Il est possible de circonscrire l'affichage de débuggage de l'option «Debug output» (pas de l'option «Template debug») à quelques machines dont on aura préalablement indiqué les adresses IP.

Pour cela, complétez la section DebugSettings du fichier de configuration de surcharge site.ini.append.php comme ceci:

[DebugSettings]
DebugByIP=enabled
DebugIPList[]
DebugIPList[]=72.160.29.13

Commentaires