From Joomla! Documentation

< API16:JError

The "API16" namespace is an archived namespace. This page contains information for a Joomla! version which is no longer supported. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.


Method to set the way the JError will handle different error levels. Use this if you want to override the default settings.

<! removed transcluded page call, red link never existed >


static setErrorHandling($level, $mode, $options=null)
Parameter Name Default Value Description
$level $level The error level for which to set the error handling
$mode $mode The mode to use for the error handling.
$options null $options Optional: Any options needed for the given mode.


mixed True on success, or a object if failed.

Defined in



jimport( 'joomla.error.error' );

Source Body

public static function setErrorHandling($level, $mode, $options = null)
        $levels = JError::$levels;

        $function = 'handle'.ucfirst($mode);
        if (!is_callable(array ('JError',$function))) {
                return JError::raiseError(E_ERROR, 'JError:'.JERROR_ILLEGAL_MODE, 'Error Handling mode is not known', 'Mode: '.$mode.' is not implemented.');

        foreach ($levels as $eLevel => $eTitle)
                if (($level & $eLevel) != $eLevel) {

                // set callback options
                if ($mode == 'callback')
                        if (!is_array($options)) {
                                return JError::raiseError(E_ERROR, 'JError:'.JERROR_ILLEGAL_OPTIONS, 'Options for callback not valid');

                        if (!is_callable($options))
                                $tmp = array ('GLOBAL');
                                if (is_array($options)) {
                                        $tmp[0] = $options[0];
                                        $tmp[1] = $options[1];
                                else {
                                        $tmp[1] = $options;

                                return JError::raiseError(E_ERROR, 'JError:'.JERROR_CALLBACK_NOT_CALLABLE, 'Function is not callable', 'Function:'.$tmp[1].' scope '.$tmp[0].'.');

                // save settings
                JError::$handlers[$eLevel] = array ('mode' => $mode);
                if ($options != null) {
                        JError::$handlers[$eLevel]['options'] = $options;

        return true;

<! removed transcluded page call, red link never existed >


Code Examples