Display handler - part 5.

$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 ignore some html_progress api errors.

An error was volontary made on call of setAnimSpeed method (lines 14 and 22). We have decided to ignore API exception (lines 4 thru 10 and 11), so only lines 24 thru 24 will be executed to catch PEAR_Error.

There is only one error into stack, this one raised at line 22.

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() [ignore 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

Error: invalid input, parameter #1 "$delay" was expecting "less or equal 1000", instead got "10000" in html_progress::setanimspeed (file d:\php\pear\html_progress\examples\errorstack\secure\display_errors-p5.php at line 22)

Catch PEAR_Error API error

[pear_error: message="invalid input, parameter #1 "$delay" was expecting "less or equal 1000", instead got "10000"" code=-100 mode=return level=notice 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, it will be ignored
    if ($err['level'] == 'exception') {
        return HTML_PROGRESS_ERRORSTACK_IGNORE;
    }
}
$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 API exception</h1>'.$e->toString());
    }
}
 
$e = $bar->setAnimSpeed(10000);   // < - - - will generate an API error
 
if (is_object($e)) {
    if (is_a($e,'PEAR_Error')) {
        die('<h1>Catch PEAR_Error API error</h1>'.$e->toString());
    }
}
?>

[Top]