En algunos casos, puedes querer personalizar la gestión de errores. Por ejemplo, para muchas excepciones, es útil incluir el archivo, número de línea, y contexto de clase/función en orden a trazar un error. Está disponible una opción por defecto que será suficiente para la mayoría de los casos, y que es PEAR_ErrorStack::getFileLine().

No todos los errores de los paquetes se producen en el archivo fuente de PHP. Por ejemplo, errores en la compilación de motores de plantillas pueden producirse en los archivos fuente de las plantillas. Los errores de las bases de datos pueden ocurrir en el texto de una sentencia, o internamente al servidor de la base de datos. Los errores relacionados con paquetes de Internet pueden ocurrir en otro servidor. Todo esta información puede incluirse en un mensaje de error usando un callback que grabe el contexto.

La información del contexto es formateada para ser fácilmente procesada por un aaplicación externa. Si quieres que la información del contexto esté en el error, el callback del mensaje de error debería emplearse para añadir la información en un formato legible por humanos al mensaje de error, tal y como se describe en la siguiente sección.

Hay tres métodos de PEAR_ErrorStack diseñados para el uso en la generación de mensajes de error eficientemente. para usarlos, debes hacer una de las dos cosas siguientes:

• Llamar a PEAR_ErrorStack::setErrorMessageTemplate(), y fijar un mapeo de array de códigos de error a plantillas de mensajes de error, como sigue:

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

  La sustitución se hace empleando http://www.php.net/str_replace, y es muy simple. Basicamente, si un nombre de variable se encierra en signos de tanto por ciento (%), será reemplazada con el valor pasado en el array asociativo. Si un array

  <?php
array('varname' => 'value');
?>
  se pasa a cualquier método, todas las ocurrencias de %varname% serán reemplazadas por el valor.

  Además, si los valores son objetos, los métodos buscarán un método llamado "__toString()" y si lo encuentran, lo usarán para convertir el objeto en una cadena. Si se pasa un error de cadenas, éstas se unirán por comas.

  <?php
array('varname' => array('first', 'second', 'third'));
// se convertir&aacute; en 'first, second, third'
?>

• Llamar PEAR_ErrorStack::setMessageCallback(), y fijar un mensaje de error personalizado generando la función o método. Esta es probablemente la mejor opción para la mayoría de situaciones complejas, dado que permite a los usuarios sobreescribir o incluso extender el callback de error exsitente usando PEAR_ErrorStack::getMessageCallback(). Por ejemplo:

  <?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'));
?>

• Extender PEAR_ErrorStack con tu propia clase, y sobreescribir PEAR_ErrorStack::getErrorMessageTemplate() o PEAR_ErrorStack::getErrorMessage(). Para garantizar qu eesta clase será utilizada por otros paquetes/aplicaciones, usa este código justo después de la declaración de la clase:

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

Hay muchos escenarios en que un control detallado sobre la generación de error es absolutamtne deseable. Un callback genérico para manejo de error significa que cada error lanzado será manejado por el mismo callback de error. Aunque PEAR_ErrorStack está diseñado para operar con callbacks independientes para cada paquete, la gestión genérica de error es posible a través del método PEAR_ErrorStack::staticPushCallback(). Esto no es diferente del modo de error de PEAR_Error, PEAR_ERROR_CALLBACK.

La autéacute;ntica fuerza de PEAR_ErrorStack procede del propio callback. El callback de PEAR_Error no tiene actualmente ningún efecto en el mensaje de error - toda la gestión de errores debe producirse en el méacute;todo empleado como callcack o en la propia función. El callback de PEAR_ErrorStack puede tener influencia sobre el error por medio del uso de tres constantes:

• PEAR_ERRORSTACK_IGNORE

• PEAR_ERRORSTACK_PUSH

• PEAR_ERRORSTACK_LOG

PEAR_ERRORSTACK_IGNORE informa a la pila para que ignore el error, como si nunca hubiese ocurrido. EL error no será ni "logueado, ni puesto en la pila. Será, no obstante, devuelto por PEAR_ErrorStack::push()

PEAR_ERRORSTACK_PUSH informa a la pila para que coloque el error en la pila de error, pero no lo loguee.

PEAR_ERRORSTACK_LOG informa a la pila para que no ponga al error en al pila de errores, y simplemente lo loguee.