Added feature #9355: Add an error and exception handler (files part 2)
authorRupert Germann <rupi@gmx.li>
Tue, 29 Sep 2009 16:56:13 +0000 (16:56 +0000)
committerRupert Germann <rupi@gmx.li>
Tue, 29 Sep 2009 16:56:13 +0000 (16:56 +0000)
git-svn-id: https://svn.typo3.org/TYPO3v4/Core/trunk@6066 709f56b5-9817-0410-a4d7-c38de5d9e867

ChangeLog
t3lib/class.t3lib_exception.php [new file with mode: 0644]
t3lib/config_default.php
t3lib/core_autoload.php
typo3/init.php
typo3/sysext/cms/tslib/index_ts.php

index 363dc7b..a328be3 100755 (executable)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2009-09-29  Rupert Germann  <rupi@gmx.li>
+
+       * Added feature #9355: Add an error and exception handler (backported from FLOW3) (thanks to Ingo Renner)
+
 2009-09-29  Oliver Hader  <oliver@typo3.org>
 
        * Fixed bug #11433: touch(): Utime failed in install tool (thanks to Steffen Gebert)
diff --git a/t3lib/class.t3lib_exception.php b/t3lib/class.t3lib_exception.php
new file mode 100644 (file)
index 0000000..ae9b9f6
--- /dev/null
@@ -0,0 +1,42 @@
+<?php
+/***************************************************************
+*  Copyright notice
+*
+*  (c) 2009 Ingo Renner <ingo@typo3.org>
+*  All rights reserved
+*
+*  This script is part of the TYPO3 project. The TYPO3 project is
+*  free software; you can redistribute it and/or modify
+*  it under the terms of the GNU General Public License as published by
+*  the Free Software Foundation; either version 2 of the License, or
+*  (at your option) any later version.
+*
+*  The GNU General Public License can be found at
+*  http://www.gnu.org/copyleft/gpl.html.
+*
+*  This script is distributed in the hope that it will be useful,
+*  but WITHOUT ANY WARRANTY; without even the implied warranty of
+*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+*  GNU General Public License for more details.
+*
+*  This copyright notice MUST APPEAR in all copies of the script!
+***************************************************************/
+
+
+
+/**
+ * An exception
+ *
+ * @package TYPO3
+ * @subpackage t3lib_error
+ * @version $Id: Exception.php 2813 2009-07-16 14:02:34Z k-fish $
+ */
+class t3lib_exception extends Exception {
+
+}
+
+if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_exception.php'])        {
+       include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_exception.php']);
+}
+
+?>
\ No newline at end of file
index 2187181..fc35411 100644 (file)
@@ -91,7 +91,6 @@ $TYPO3_CONF_VARS = Array(
                'dbClientCompress' => 0,                                // Boolean: if true, data exchange between TYPO3 and database server will be compressed. This may improve performance if (1) database serever is on the different server and (2) network connection speed to database server is 100mbps or less. CPU usage will be higher if this option is used but database operations will be executed faster due to much less (up to 3 times) database network traffic. This option has no effect if MySQL server is localhost.
                'setMemoryLimit' => 0,                                  // Integer, memory_limit in MB: If more than 16, TYPO3 will try to use ini_set() to set the memory limit of PHP to the value. This works only if the function ini_set() is not disabled by your sysadmin.
                'forceReturnPath' => 0,                                 // Boolean: Force return path to be applied in mail() calls. If this is set, all calls to mail() done by t3lib_htmlmail will be called with '-f<return_path> as the 5th parameter. This will make the return path correct on almost all Unix systems. There is a known problem with Postfix below version 2: Mails are not sent if this option is set and Postfix is used. On Windows platforms, the return path is set via a call to ini_set. This has no effect if safe_mode in PHP is on.
-               'displayErrors' => -1,                                  // Integer, -1,0,1,2. 0=Do not display any PHP error messages. 1=Display error messages. 2=Display only if client matches TYPO3_CONF_VARS[SYS][devIPmask]. -1=Default setting. With this option, you can override the PHP setting "display_errors". It is suggested that you set this to "0" and enable the "error_log" option in php.ini instead.
                'serverTimeZone' => 1,                                  // Integer, GMT offset of servers time (from time()). Default is "1" which is "GMT+1" (central european time). This value can be used in extensions that are GMT aware and wants to convert times to/from other timezones.
                'systemLog' => '',                                              // String, semi-colon separated list: Defines one or more logging methods. Possible methods: file,<abs-path-to-file>[,<level>];mail,<to>[/<from>][,<level>];syslog,<facility>,[,<level>];error_log[,,<level>]. "file" logs to a file, "mail" sends the log entries via mail, "syslog" uses the operating system's log, "error_log" uses the PHP error log. The level is the individual logging level (see [SYS][systemLogLevel]. Facility may be one of LOCAL0..LOCAL7, USER (on Windows USER is the only valid type).
                'systemLogLevel' => 0,                                  // Integer: Only messages with same or higher severity are logged; 0 is info, 1 is notice, 2 is warning, 3 is error, 4 is fatal error.
@@ -156,6 +155,10 @@ $TYPO3_CONF_VARS = Array(
                        )
                ),
                'useCachingFramework' => 0,                             // Boolean: Enable this if you want to use the caching framework by default for the core caches cache_pages, cache_pagesection and cache_hash.
+               'displayErrors' => -1,                                  // Integer, -1,0,1,2. 0=Do not display any PHP error messages. 1=Display error messages. 2=Display only if client matches TYPO3_CONF_VARS[SYS][devIPmask]. -1=Default setting. With this option, you can override the PHP setting "display_errors". It is suggested that you set this to "0" and enable the "error_log" option in php.ini instead.
+               'exceptionHandler'  => 't3lib_error_ProductionExceptionHandler',        // String: Classname to handle exceptions that might happen in the TYPO3-code. Leave empty to disable exception handling, or set to t3lib_error_ProductionExceptionHandler for nice error messages when something wents wrong, or to t3lib_error_DebugExceptionHandler for a complete stack trace of any encountered exception. Note that if devIPmask matches, t3lib_error_DebugExceptionHandler will be used, regardless of this setting.
+               'errorHandler'      => 't3lib_error_ErrorHandler',      // String: Classname to handle PHP errors. The default will turn the error into an exception (to be handled by the exceptionHandler).
+               'exceptionalErrors' => E_ALL ^ E_NOTICE,        // Integer: The E_* constant that will be handled as an exception by t3lib_error_ErrorHandler. Default is "E_ALL ^ E_NOTICE" (6135) and "0" if displayError=0. Some values for errors: E_ALL=6143, E_ALL ^ E_NOTICE ^ E_WARNING=6133. See php documentation for more details on this integer.
        ),
        'EXT' => Array (        // Options related to the Extension Management
                'noEdit' => 1,                                                  // Boolean: If set, the Extension Manager does NOT allow extension files to be edited! (Otherwise both local and global extensions can be edited.)
@@ -478,17 +481,27 @@ function debugEnd() {
        // Init services array:
 $T3_SERVICES = array();
 
+       // Error & exception handling
+$TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler'] = $TYPO3_CONF_VARS['SYS']['exceptionHandler'];
+$TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionalErrors'] = $TYPO3_CONF_VARS['SYS']['exceptionalErrors'];
 
        // Turn error logging on/off.
 if (($displayErrors=intval($TYPO3_CONF_VARS['SYS']['displayErrors']))!='-1')   {
        if ($displayErrors==2)  {       // Special value "2" enables this feature only if $TYPO3_CONF_VARS[SYS][devIPmask] matches
                if (t3lib_div::cmpIP(t3lib_div::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask']))    {
                        $displayErrors=1;
+                       $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler'] = 't3lib_error_DebugExceptionHandler';
                } else {
                        $displayErrors=0;
                }
        }
+       if ($displayErrors == 0)        {
+               $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionalErrors'] = 0;
+       }
        @ini_set('display_errors', $displayErrors);
+} elseif (t3lib_div::cmpIP(t3lib_div::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask']))     {
+               // with displayErrors = -1 (default), turn on debugging if devIPmask matches:
+       $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler'] = 't3lib_error_DebugExceptionHandler';
 }
 
        // Set PHP memory limit depending on value of $TYPO3_CONF_VARS["SYS"]["setMemoryLimit"]
index 2191d8c..432dfc1 100644 (file)
@@ -21,6 +21,7 @@ return array(
        't3lib_db' => PATH_t3lib . 'class.t3lib_db.php',
        't3lib_diff' => PATH_t3lib . 'class.t3lib_diff.php',
        't3lib_div' => PATH_t3lib . 'class.t3lib_div.php',
+       't3lib_exception' => PATH_t3lib . 'class.t3lib_exception.php',
        't3lib_exec' => PATH_t3lib . 'class.t3lib_exec.php',
        't3lib_extfilefunctions' => PATH_t3lib . 'class.t3lib_extfilefunc.php',
        't3lib_extmgm' => PATH_t3lib . 'class.t3lib_extmgm.php',
@@ -101,6 +102,13 @@ return array(
        't3lib_cache_frontend_stringfrontend' => PATH_t3lib . 'cache/frontend/class.t3lib_cache_frontend_stringfrontend.php',
        't3lib_cache_frontend_variablefrontend' => PATH_t3lib . 'cache/frontend/class.t3lib_cache_frontend_variablefrontend.php',
        't3lib_cache_frontend_frontend' => PATH_t3lib . 'cache/frontend/interfaces/interface.t3lib_cache_frontend_frontend.php',
+       't3lib_error_abstractexceptionhandler' => PATH_t3lib . 'error/class.t3lib_error_abstractexceptionhandler.php',
+       't3lib_error_debugexceptionhandler' => PATH_t3lib . 'error/class.t3lib_error_debugexceptionhandler.php',
+       't3lib_error_errorhandler' => PATH_t3lib . 'error/class.t3lib_error_errorhandler.php',
+       't3lib_error_exception' => PATH_t3lib . 'error/class.t3lib_error_exception.php',
+       't3lib_error_errorhandlerinterface' => PATH_t3lib . 'error/interface.t3lib_error_errorhandlerinterface.php',
+       't3lib_error_exceptionhandlerinterface' => PATH_t3lib . 'error/interface.t3lib_error_exceptionhandlerinterface.php',
+       't3lib_error_productionexceptionhandler' => PATH_t3lib . 'error/class.t3lib_error_productionexceptionhandler.php',
        't3lib_browselinkshook' => PATH_t3lib . 'interfaces/interface.t3lib_browselinkshook.php',
        't3lib_localrecordlistgettablehook' => PATH_t3lib . 'interfaces/interface.t3lib_localrecordlistgettablehook.php',
        't3lib_singleton' => PATH_t3lib . 'interfaces/interface.t3lib_singleton.php',
index 8d1fdf8..8d75754 100644 (file)
@@ -184,6 +184,16 @@ require_once(PATH_t3lib . 'class.t3lib_autoloader.php');
 t3lib_autoloader::registerAutoloader();
 
 
+// *********************
+// Error & Exception handling
+// *********************
+if ($TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler'] !== '') {
+       $errorHandler = t3lib_div::makeInstance($TYPO3_CONF_VARS['SYS']['errorHandler']);
+               // register an error handler for the given exceptionalErrors
+       $errorHandler->setErrorHandlerForExceptionalErrors($TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionalErrors']);
+       $exceptionHandler = t3lib_div::makeInstance($TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler']);
+}
+
 /** @var TYPO3_DB t3lib_db */
 $TYPO3_DB = t3lib_div::makeInstance('t3lib_DB');
 $TYPO3_DB->debugOutput = $TYPO3_CONF_VARS['SYS']['sqlDebug'];
index 3a84a23..9693a7e 100644 (file)
@@ -127,6 +127,18 @@ $TT->push('Register Autoloader', '');
 $TT->pull();
 
 
+// *********************
+// Error & Exception handling
+// *********************
+if ($TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler'] !== '') {
+       $TT->push('Register Exceptionhandler', '');
+               $errorHandler = t3lib_div::makeInstance($TYPO3_CONF_VARS['SYS']['errorHandler']);
+                       // register an error handler for the given exceptionalErrors
+               $errorHandler->setErrorHandlerForExceptionalErrors($TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionalErrors']);
+               $exceptionHandler = t3lib_div::makeInstance($TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler']);
+       $TT->pull();
+}
+
 $TYPO3_DB = t3lib_div::makeInstance('t3lib_DB');
 $TYPO3_DB->debugOutput = $TYPO3_CONF_VARS['SYS']['sqlDebug'];