Dans certains cas, vous pouvez souhaiter personnaliser la génération des erreurs. Par exemple, pour beaucoup d'exceptions, il est utile d'inclure comme informations contextuelles : le nom de fichier, le numéro de ligne et le nom de la classe/fonction afin de tracer l'erreur. Une option par défaut est disponible et sera suffisante dans la majorité des cas, c'est : PEAR_ErrorStack::getFileLine().

Toutes les erreurs de paquet n'apparaissent pas dans le fichier source PHP lui même. Par exemple, les erreurs de compilation d'un moteur de templates apparaissent dans le fichier source du modèle, les erreurs de base de données peuvent se produire dans le texte d'une requête, ou d'une manière interne au serveur de base de données, les erreurs propres aux paquets Internet peuvent apparaître sur un autre serveur. Toutes ces informations peuvent être incluses dans un message d'erreur en utilisant une fonction de rappel capturant le contexte.

L'information contextuelle est formatée pour être facilement traitée par une application externe. Si vous souhaitez que les informations contextuelles soient incluses dans le message d'erreur, la fonction de rappel de message d'erreur devrait être utilisée pour ajouter cette information d'une manière humainement lisible au message d'erreur, tel que décrit dans la section suivante.

Il y a trois méthodes de PEAR_ErrorStack prévues pour générer des messages d'erreur de manière efficace. Pour les utiliser, vous devez faire une des deux choses suivantes :

• Appeler PEAR_ErrorStack::setErrorMessageTemplate(), et configurer un tableau en mettant en correspondance les codes d'erreurs et les modèles correspondants, comme ceci :

  <?php
define('ERREUR_UN', 1);
define('ERREUR_DEUX', 2);
define('ERREUR_TROIS', 3);
define('ERREUR_QUATRE', 4);
require_once 'PEAR/ErrorStack.php';
$stack = &PEAR_ErrorStack::singleton('monpackage');
$messages = array(
    ERREUR_UN => 'The gronk number %num% dropped a %thing%',
    ERREUR_DEUX => 'The %list% items were missing',
    ERREUR_TROIS => 'I like chocolate, how about %you%?',
    ERREUR_QUATRE => 'and a %partridge% in a pear %tree%',
);
$stack->setErrorMessageTemplate($messages);
?>

  La substitution est faite en utilisant la fonction PHP str_replace, et est très simple. Basiquement, si un nom de variable est entouré de signes pourcentage (%), il sera remplacé par la valeur passée dans le tableau associatif. Si un tableau est passé en paramètre à la méthode,

  <?php
array('nomvar' => 'valeur');
?>

  , toutes les occurrences de %nomvar% seront remplacées par leur valeur.

  De plus, si les valeurs passées sont des objets, les méthodes de substitution chercheront dans l'objet une méthode nommée "__toString()()" et si elle est trouvée, elle sera utilisée pour convertir l'objet en chaîne. Si un tableau de chaînes est passé, elles seront jointes par des virgules.

  <?php
array('nomvar' => array('premier', 'second', 'tiers'));
// Deviendra : 'premier, second, tiers'
?>

• Appel de PEAR_ErrorStack::setMessageCallback(), et paramétrer une fonction ou méthode générant un message d'erreur personnalisé. Ceci est probablement la meilleur option dans la majorité des situations complexes, dans la mesure où cela autorise les utilisateurs à remplacer ou même étendre la fonction de callback existante en utilisant PEAR_ErrorStack::getMessageCallback(). Par exemple:

  <?php
require_once 'PEAR/ErrorStack.php';
class foo
{
    var $_oldcallback;
    function callback(&$stack, $err)
    {
        $message = call_user_func_array($this->_oldcallback, array(&$stack, $err));
        $message .= "File " . $err['context']['file'];
        return $message;
    }
}
$a = new foo;
$stack = &PEAR_ErrorStack::singleton('otherpackage');
$a->_oldcallback = $stack->getMessageCallback('otherpackage');
$stack->setMessageCallback(array(&$a, 'callback'));
?>

• étendre PEAR_ErrorStack avec votre propre classe et remplacer PEAR_ErrorStack::getErrorMessageTemplate() ou PEAR_ErrorStack::getErrorMessage(). Afin de garantir que cette classe sera utilisée par d'autres pacquets / applications, utilisez ce code juste après la déclaration de la classe :

  <?php
PEAR_ErrorStack::singleton('monpackage', false, null, 'MyPEAR_ErrorStack');
?>

Il existe plusieurs scénarios dans lesquels le contrôle d'une fine granularité sur la levée d'une erreur est absolument nécessaire. Une fonction générique de callback de gestion des erreurs implique que chaque erreur levée sera gérée dans la même fonction de rappel. Même si PEAR_ErrorStack est conçu pour opérer avec des fonctions de rappel indépendantes pour chaque paquet, une gestion générique est possible à travers la méthode PEAR_ErrorStack::staticPushCallback(). Ce n'est pas différent du mode PEAR_ERROR_CALLBACK de gestion d'erreurs PEAR_Error.

La puissance réelle de PEAR_ErrorStack vient du mécanisme de callback lui-même. Le mécanisme de callback PEAR_Error n'a pas vraiment d'effet sur le message d'erreur - tous les traitements d'erreurs doivent être effectuées dans la méthode ou la fonction de rappel elle-même. Le mécanisme de rappel PEAR_ErrorStack peut influencer l'erreur à travers l'utilisation de trois constantes :

• PEAR_ERRORSTACK_IGNORE

• PEAR_ERRORSTACK_PUSH

• PEAR_ERRORSTACK_LOG

PEAR_ERRORSTACK_IGNORE informe la pile qu'elle doit ignorer l'erreur, comme si elle n'était jamais arrivée. L'erreur ne sera ni loguée, ni mise sur la pile. Elle pourra cependant être retournée par PEAR_ErrorStack::push().

PEAR_ERRORSTACK_PUSH informe la pile qu'elle doit empiler l'erreur sur la pile des erreurs, mais ne pas la loguer.

PEAR_ERRORSTACK_LOG informe la pile qu'elle ne doit pas empiler l'erreur mais seulement la loguer.