*
* This contains the custom error handler for SquirrelMail.
*
- * @copyright © 2005-2006 The SquirrelMail Project Team
+ * @copyright 2005-2010 The SquirrelMail Project Team
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
* @version $Id$
* @package squirrelmail
* @since 1.5.1
*/
function ErrorHandler(&$oTemplate, $sTemplateFile) {
+# echo 'init error handler...';
$this->TemplateName = $sTemplateFile;
$this->Template =& $oTemplate;
$this->aErrors = array();
+ $this->header_sent = false;
+ $this->delayed_errors = false;
+ $this->Template->assign('delayed_errors', $this->delayed_errors);
}
/**
$this->TemplateFile = $sTemplateFile;
}
+ /**
+ * Sets if the page header is already sent
+ * @since 1.5.1
+ */
+ function HeaderSent() {
+ $this->header_sent = true;
+ $this->Template->assign('header_sent', true);
+ }
+
+ /**
+ * Turn on/off delayed error handling
+ * @since 1.5.2
+ */
+ function setDelayedErrors ($val = true) {
+ $this->delayed_errors = $val===true;
+ $this->Template->assign('delayed_errors', $this->delayed_errors);
+ }
+
+ /**
+ * Store errors generated in a previous script but couldn't be displayed
+ * due to a header redirect. This requires storing of aDelayedErrors in the session
+ * @param array $aDelayedErrors array with errors stored in the $this->aErrors format.
+ * @since 1.5.1
+ */
+ function AssignDelayedErrors(&$aDelayedErrors) {
+ $aErrors = array_merge($this->aErrors,$aDelayedErrors);
+ $this->aErrors = $aErrors;
+ $this->Template->assign('aErrors',$this->aErrors);
+ $aDelayedErrors = false;
+ }
+
+
/**
* Custom Error handler (set with set_error_handler() )
* @private
$aError['message'] = $sErrStr;
$aError['extra'] = array(
'FILE' => $sErrFile,
- 'LINE' => $iErrLine) ;;
+ 'LINE' => $iErrLine) ;
// what todo with $aContext?
break;
case E_USER_ERROR:
}
if ($aError['category'] & SQM_ERROR_PLUGIN) {
$aErrorCategory[] = 'PLUGIN';
- do_hook_function('error_handler_plugin',$aError);
+ do_hook('error_handler_plugin', $aError);
// plugin related error handling inside
}
//if ($aError['category'] & SQM_ERROR_X) {
default: break;
}
+ /**
+ * If delayed error handling is enabled, always record the location
+ * and tag the error is delayed to make debugging easier.
+ */
+ if (isset($this->Template->values['delayed_errors']) && $this->Template->values['delayed_errors']) {
+ $aErrorCategory[] = 'Delayed';
+ $aError['extra'] = array(
+ 'FILE' => $sErrFile,
+ 'LINE' => $iErrLine) ;
+ }
+
$aErrorTpl = array(
'type' => $iType,
'category' => $aErrorCategory,
// Show the error immediate in case of fatal errors
if ($iType == SQM_ERROR) {
+ if (isset($this->Template->values['header_sent']) && !$this->Template->values['header_sent']) {
+// TODO replace this with template that can be assigned
+// UPDATE: displayHtmlHeader() no longer sends anything
+// directly to the browser itself and instead
+// displays all output through the template file
+// "protocol_header" as well as calls to the
+// template's header() method, so perhaps the
+// above TODO is alleviated?? (however, I don't fully
+// understand the problem behind the TODO comment myself (Paul))
+ displayHtmlHeader(_("Error"),'',false);
+ }
$this->DisplayErrors();
exit(_("Terminating SquirrelMail due to a fatal error"));
}
}
+ /**
+ * Force the delayed errors to be stored in the session in case
+ * $this->displayErrors() never gets called, e.g. in compose.php
+ */
+ function saveDelayedErrors () {
+ if($this->delayed_errors) {
+ // Check for previous delayed errors...
+ sqgetGlobalVar('delayed_errors', $delayed_errors, SQ_SESSION);
+ if (is_array($delayed_errors)) {
+ $this->AssignDelayedErrors($delayed_errors);
+ sqsession_unregister("delayed_errors");
+ }
+
+ if (count($this->aErrors) > 0) {
+ sqsession_register($this->aErrors,"delayed_errors");
+ }
+ }
+ }
+
/**
* Display the error array in the error template
* @return void
* @since 1.5.1
*/
function DisplayErrors() {
- if (count($this->aErrors)) {
- $this->Template->display($this->TemplateName);
+ // Check for delayed errors...
+ if (!$this->delayed_errors) {
+ sqgetGlobalVar('delayed_errors', $delayed_errors, SQ_SESSION);
+ if (is_array($delayed_errors)) {
+ $this->AssignDelayedErrors($delayed_errors);
+ sqsession_unregister("delayed_errors");
+ }
+ }
+
+ if (isset($this->Template->values['aErrors']) && count($this->Template->values['aErrors']) > 0) {
+ foreach ($this->Template->values['aErrors'] as $err) {
+ if (!in_array($err, $this->aErrors, true)) {
+ $this->aErrors[] = $err;
+ }
+ }
+ $this->Template->assign('aErrors',$this->aErrors);
+ }
+
+ if (count($this->aErrors) > 0) {
+ if ($this->delayed_errors) {
+ sqsession_register($this->aErrors,"delayed_errors");
+ } else {
+ $this->Template->display($this->TemplateName);
+ }
}
}
}
/**
* Triggers an imap error. Utility function for sqm_trigger_error()
- * @param integer $iErrNo error number defined in errors.php
+ * @param string $sErrNo error string defined in errors.php
* @param string $sRequest imap request string
* @param string $sResponse tagged imap response
* @param string $sMessage tagged imap response message
* @author Marc Groot Koerkamp
* @since 1.5.1
*/
-function sqm_trigger_imap_error($iErrNo,$sRequest,$sResponse, $sMessage, $aExtra=array()) {
+function sqm_trigger_imap_error($sErrNo,$sRequest,$sResponse, $sMessage, $aExtra=array()) {
$aError = array(
'REQUEST' => $sRequest,
'RESPONSE' => $sResponse,
'MESSAGE' => $sMessage);
$aError = array_merge($aExtra,$aError);
- sqm_trigger_error($iErrNo,$aError);
+ sqm_trigger_error($sErrNo,$aError);
}
/**
* Trigger an error.
- * @param integer $iErrNo error number defined in errors.php
+ * @param string $sErrNo error string defined in errors.php
* @param array $aExtra optional associative array with extra error info
* @return void
* @author Marc Groot Koerkamp
* @since 1.5.1
*/
-function sqm_trigger_error($iErrNo,$aExtra=array()) {
- // Include the error definition file.
- include_once(SM_PATH.'include/errors.php');
+function sqm_trigger_error($sErrNo,$aExtra=array()) {
+ static $aErrors;
+ if (!isset($aErrors)) {
+ // Include the error definition file.
+ include_once(SM_PATH.'include/errors.php');
+ }
+
$iPhpErr = E_USER_NOTICE;
- if (is_array($aErrors) && isset($aErrors[$iErrNo]['level'])) {
+ if (is_array($aErrors) && isset($aErrors[$sErrNo]['level'])) {
if (is_array($aExtra) && count($aExtra)) {
- $aErrors[$iErrNo]['extra'] = $aExtra;
+ $aErrors[$sErrNo]['extra'] = $aExtra;
}
// because trigger_error can only handle a string argument for the error description
// we serialize the result.
- $sErrString = serialize($aErrors[$iErrNo]);
- $iPhpErr = $aErrors[$iErrNo]['level'];
+ $sErrString = serialize($aErrors[$sErrNo]);
+ $iPhpErr = $aErrors[$sErrNo]['level'];
} else {
- $sErrString = "Error number <$iErrNo> does not exist, fix the code or update the errors.php file";
+ sm_print_r($aErrors);
+ $sErrString = "Error <$sErrNo> does not exist, fix the code or update the errors.php file";
$iPhpErr = E_USER_ERROR;
}
trigger_error($sErrString, $iPhpErr);
}
-?>
\ No newline at end of file