Display handler - part 4.

$Date: 2004/08/07 14:28:59 $

Table of contents

Introduction
Render options
Ouput
PHP source syntax highlight

Introduction

This example requires :

PEAR::HTML_Progress 1.2.0 or better.
PEAR.

This example will show you how to handle html_progress api exceptions without die.

An error was volontary made on call of setAnimSpeed method (line 14). It's an API exception, and we have decided to push and logs this error (lines 4 thru 10, and 11), so only lines 16 thru 20 will be executed.

display_errors

Print out errors (as a part of the output). For production web sites, you're strongly encouraged to turn this feature off, and use error logging instead. Keeping display_errors enabled on a production web site may reveal security information to end users, such as file paths on your Web server, your database schema or other information.

1	<?php ini_set('display_errors', false); ?>

log_errors

Log errors into a log file (server-specific log, stderr, syslog ...) As stated above, you're strongly advised to use error logging in place of error displaying on production web sites.

1	<?php ini_set('log_errors', true); ?>

Render options

Default options below are used :

error_handler : callback HTML_Progress::_errorHandler() [use PEAR_Error]
message_callback : callback HTML_Progress::_msgCallback()
context_callback : callback HTML_Progress::_getBacktrace()
handler/display/conf/lineFormat : '%1$s: %2$s %3$s'
handler/display/conf/contextFormat : ' in %3$s (file %1$s at line %2$s)'

Only option changed is :

push_callback : callback _pushCallback() [push and logs if error is an exception]

Legend for lineFormat:

1$ = error level
2$ = message body
3$ = error context (class/method/file/line)

Legend for contextFormat:

1$ = filename
2$ = line number
3$ = class and method names

[Top]

Output

Exception: invalid input, parameter #1 "$delay" was expecting "integer", instead got "string" in html_progress::setanimspeed (file d:\php\pear\html_progress\examples\errorstack\secure\display_errors-p4.php at line 14)

Catch PEAR_Error

[pear_error: message="invalid input, parameter #1 "$delay" was expecting "integer", instead got "string"" code=-100 mode=return level=error prefix="" info="Array"]

[Top]

PHP source syntax highlight

<?php 
require_once 'HTML/Progress.php';
 
function _pushCallback($err)
{
    // now don't die if the error is an exception
    if ($err['level'] == 'exception') {
        return HTML_PROGRESS_ERRORSTACK_PUSHANDLOG;
    }
}
$logger['push_callback'] = '_pushCallback';
 
$bar = new HTML_Progress($logger);
$e = $bar->setAnimSpeed('100');   // < - - - will generate an API exception
 
if (is_object($e)) {
    if (is_a($e,'PEAR_Error')) {
        die('<h1>Catch PEAR_Error</h1>'.$e->toString());
    }
}
 
if ($bar->hasErrors()) {
    $err = $bar->getError();
    echo '<pre>';
    print_r($err);
    echo '</pre>';
    die('<h1>Catch HTML_Progress error</h1>');
}
?>

[Top]