Inheritance diagram for Log:

Collaboration diagram for Log:

Public Member Functions
	_classExists ($class)
	Utility function which wraps PHP's class_exists() function to ensure consistent behavior between PHP versions 4 and 5. More...

&	factory ($handler, $name='', $ident='', $conf=array(), $level=PEAR_LOG_DEBUG)
	Attempts to return a concrete Log instance of type $handler. More...

&	singleton ($handler, $name='', $ident='', $conf=array(), $level=PEAR_LOG_DEBUG)
	Attempts to return a reference to a concrete Log instance of type $handler, only creating a new instance if no log instance with the same parameters currently exists. More...

	open ()
	Abstract implementation of the open() method. More...

	close ()
	Abstract implementation of the close() method. More...

	flush ()
	Abstract implementation of the flush() method. More...

	log ($message, $priority=null)
	Abstract implementation of the log() method. More...

	emerg ($message)
	A convenience function for logging a emergency event. More...

	alert ($message)
	A convenience function for logging an alert event. More...

	crit ($message)
	A convenience function for logging a critical event. More...

	err ($message)
	A convenience function for logging a error event. More...

	warning ($message)
	A convenience function for logging a warning event. More...

	notice ($message)
	A convenience function for logging a notice event. More...

	info ($message)
	A convenience function for logging a information event. More...

	debug ($message)
	A convenience function for logging a debug event. More...

	_extractMessage ($message)
	Returns the string representation of the message data. More...

	_getBacktraceVars ($depth)
	Using debug_backtrace(), returns the file, line, and enclosing function name of the source code context from which log() was invoked. More...

	_format ($format, $timestamp, $priority, $message)
	Produces a formatted log line based on a format string and a set of variables representing the current log record and state. More...

	priorityToString ($priority)
	Returns the string representation of a PEAR_LOG_* integer constant. More...

	stringToPriority ($name)
	Returns the the PEAR_LOG_* integer constant for the given string representation of a priority name. More...

	MASK ($priority)
	Calculate the log mask for the given priority. More...

	UPTO ($priority)
	Calculate the log mask for all priorities up to the given priority. More...

	MIN ($priority)
	Calculate the log mask for all priorities greater than or equal to the given priority. More...

	MAX ($priority)
	Calculate the log mask for all priorities less than or equal to the given priority. More...

	setMask ($mask)
	Set and return the level mask for the current Log instance. More...

	getMask ()
	Returns the current level mask. More...

	_isMasked ($priority)
	Check if the given priority is included in the current level mask. More...

	getPriority ()
	Returns the current default priority. More...

	setPriority ($priority)
	Sets the default priority to the specified value. More...

	attach (&$observer)
	Adds a Log_observer instance to the list of observers that are listening for messages emitted by this Log instance. More...

	detach ($observer)
	Removes a Log_observer instance from the list of observers. More...

	_announce ($event)
	Informs each registered observer instance that a new message has been logged. More...

	isComposite ()
	Indicates whether this is a composite class. More...

	setIdent ($ident)
	Sets this Log instance's identification string. More...

	getIdent ()
	Returns the current identification string. More...

Data Fields
	$_opened = false

	$_id = 0

	$_ident = ''

	$_priority = PEAR_LOG_INFO

	$_mask = PEAR_LOG_ALL

	$_listeners = array()

	$_formatMap

Detailed Description

Definition at line 37 of file Log.php.

Member Function Documentation

◆ _announce()

Log::_announce ( $event )

Informs each registered observer instance that a new message has been logged.

Parameters

array $event A hash describing the log event.

@access protected

Definition at line 811 of file Log.php.

    {
        foreach ($this->_listeners as $id => $listener) {
            if ($event['priority'] <= $this->_listeners[$id]->_priority) {
                $this->_listeners[$id]->notify($event);
            }
        }
    }

Referenced by Log_composite\log(), Log_console\log(), Log_daemon\log(), Log_display\log(), Log_error_log\log(), Log_file\log(), Log_firebug\log(), Log_mail\log(), Log_mcal\log(), Log_mdb2\log(), Log_null\log(), Log_sql\log(), Log_sqlite\log(), Log_syslog\log(), and Log_win\log().

Here is the caller graph for this function:

◆ _classExists()

Log::_classExists ( $class )

Utility function which wraps PHP's class_exists() function to ensure consistent behavior between PHP versions 4 and 5.

Autoloading behavior is always disabled.

Parameters

string $class The name of the class whose existence should be tested.

Returns: bool True if the class exists.

@access private

Since: Log 1.9.13

Definition at line 117 of file Log.php.

    {
        if (version_compare(PHP_VERSION, '5.0.0', 'ge')) {
            return class_exists($class, false);
        }
 
        return class_exists($class);
    }

Referenced by factory().

Here is the caller graph for this function:

◆ _extractMessage()

Log::_extractMessage ( $message )

Returns the string representation of the message data.

If $message is an object, _extractMessage() will attempt to extract the message text using a known method (such as a PEAR_Error object's getMessage() method). If a known method, cannot be found, the serialized representation of the object will be returned.

If the message data is already a string, it will be returned unchanged.

Parameters

mixed $message The original message data. This may be a string or any object.

Returns: string The string representation of the message.

@access protected

Definition at line 417 of file Log.php.

    {
        /*
         * If we've been given an object, attempt to extract the message using
         * a known method.  If we can't find such a method, default to the
         * "human-readable" version of the object.
         *
         * We also use the human-readable format for arrays.
         */
        if (is_object($message)) {
            if (method_exists($message, 'getmessage')) {
                $message = $message->getMessage();
            } else if (method_exists($message, 'tostring')) {
                $message = $message->toString();
            } else if (method_exists($message, '__tostring')) {
                if (version_compare(PHP_VERSION, '5.0.0', 'ge')) {
                    $message = (string)$message;
                } else {
                    $message = $message->__toString();
                }
            } else {
                $message = var_export($message, true);
            }
        } else if (is_array($message)) {
            if (isset($message['message'])) {
                if (is_scalar($message['message'])) {
                    $message = $message['message'];
                } else {
                    $message = var_export($message['message'], true);
                }
            } else {
                $message = var_export($message, true);
            }
        } else if (is_bool($message) || $message === NULL) {
            $message = var_export($message, true);
        }
 
        /* Otherwise, we assume the message is a string. */
        return $message;
    }

Referenced by Log_console\log(), Log_daemon\log(), Log_display\log(), Log_error_log\log(), Log_file\log(), Log_firebug\log(), Log_mail\log(), Log_mcal\log(), Log_mdb2\log(), Log_sql\log(), Log_sqlite\log(), Log_syslog\log(), and Log_win\log().

Here is the caller graph for this function:

◆ _format()

Log::_format	(	$format,
		$timestamp,
		$priority,
		$message
	)

Produces a formatted log line based on a format string and a set of variables representing the current log record and state.

Returns: string Formatted log string.

@access protected

Since: Log 1.9.4

Definition at line 530 of file Log.php.

    {
        /*
         * If the format string references any of the backtrace-driven
         * variables (%5 %6,%7,%8), generate the backtrace and fetch them.
         */
        if (preg_match('/%[5678]/', $format)) {
            list($file, $line, $func, $class) = $this->_getBacktraceVars(2);
        }
 
        /*
         * Build the formatted string.  We use the sprintf() function's
         * "argument swapping" capability to dynamically select and position
         * the variables which will ultimately appear in the log string.
         */
        return sprintf($format,
                       $timestamp,
                       $this->_ident,
                       $this->priorityToString($priority),
                       $message,
                       isset($file) ? $file : '',
                       isset($line) ? $line : '',
                       isset($func) ? $func : '',
                       isset($class) ? $class : '');
    }

References $file, $timestamp, _getBacktraceVars(), and priorityToString().

Referenced by Log_console\log(), Log_display\log(), Log_error_log\log(), Log_file\log(), Log_firebug\log(), and Log_mail\log().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getBacktraceVars()

Log::_getBacktraceVars ( $depth )

Using debug_backtrace(), returns the file, line, and enclosing function name of the source code context from which log() was invoked.

Parameters

int $depth The initial number of frames we should step back into the trace.

Returns: array Array containing four strings: the filename, the line, the function name, and the class name from which log() was called.

@access private

Since: Log 1.9.4

Definition at line 472 of file Log.php.

    {
        /* Start by generating a backtrace from the current call (here). */
        $bt = debug_backtrace();
 
        /*
         * If we were ultimately invoked by the composite handler, we need to
         * increase our depth one additional level to compensate.
         */
        $class = isset($bt[$depth+1]['class']) ? $bt[$depth+1]['class'] : null;
        if ($class !== null && strcasecmp($class, 'Log_composite') == 0) {
            $depth++;
            $class = isset($bt[$depth + 1]) ? $bt[$depth + 1]['class'] : null;
        }
 
        /*
         * We're interested in the frame which invoked the log() function, so
         * we need to walk back some number of frames into the backtrace.  The
         * $depth parameter tells us where to start looking.   We go one step
         * further back to find the name of the encapsulating function from
         * which log() was called.
         */
        $file = isset($bt[$depth])     ? $bt[$depth]['file'] : null;
        $line = isset($bt[$depth])     ? $bt[$depth]['line'] : 0;
        $func = isset($bt[$depth + 1]) ? $bt[$depth + 1]['function'] : null;
 
        /*
         * However, if log() was called from one of our "shortcut" functions,
         * we're going to need to go back an additional step.
         */
        if (in_array($func, array('emerg', 'alert', 'crit', 'err', 'warning',
                                  'notice', 'info', 'debug'))) {
            $file = isset($bt[$depth + 1]) ? $bt[$depth + 1]['file'] : null;
            $line = isset($bt[$depth + 1]) ? $bt[$depth + 1]['line'] : 0;
            $func = isset($bt[$depth + 2]) ? $bt[$depth + 2]['function'] : null;
        }
 
        /*
         * If we couldn't extract a function name (perhaps because we were
         * executed from the "main" context), provide a default value.
         */
        if (is_null($func)) {
            $func = '(none)';
        }
 
        /* Return a 4-tuple containing (file, line, function, class). */
        return array($file, $line, $func, $class);
    }

References $file.

Referenced by _format().

Here is the caller graph for this function:

◆ _isMasked()

Log::_isMasked ( $priority )

Check if the given priority is included in the current level mask.

Parameters

integer $priority The priority to check.

Returns: boolean True if the given priority is included in the current log mask.

@access protected

Since: Log 1.7.0

Definition at line 726 of file Log.php.

    {
        return (Log::MASK($priority) & $this->_mask);
    }

References MASK().

Referenced by Log_console\log(), Log_daemon\log(), Log_display\log(), Log_error_log\log(), Log_file\log(), Log_firebug\log(), Log_mail\log(), Log_mcal\log(), Log_mdb2\log(), Log_null\log(), Log_sql\log(), Log_sqlite\log(), Log_syslog\log(), and Log_win\log().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ alert()

Log::alert ( $message )

A convenience function for logging an alert event.

It will log a message at the PEAR_LOG_ALERT log level.

Parameters

mixed $message String or object containing the message to log.

Returns: boolean True if the message was successfully logged.

@access public

Since: Log 1.7.0

Definition at line 293 of file Log.php.

    {
        return $this->log($message, PEAR_LOG_ALERT);
    }

References log(), and PEAR_LOG_ALERT.

Here is the call graph for this function:

◆ attach()

Log::attach ( & $observer )

Adds a Log_observer instance to the list of observers that are listening for messages emitted by this Log instance.

Parameters

object	$observer	The Log_observer instance to attach as a listener.
	boolean	True if the observer is successfully attached.

@access public

Since: Log 1.0

Definition at line 769 of file Log.php.

    {
        if (!is_a($observer, 'Log_observer')) {
            return false;
        }
 
        $this->_listeners[$observer->_id] = &$observer;
 
        return true;
    }

◆ close()

Log::close ( )

Abstract implementation of the close() method.

Since: Log 1.0

Reimplemented in Log_composite, Log_console, Log_daemon, Log_display, Log_error_log, Log_file, Log_firebug, Log_mail, Log_mcal, Log_mdb2, Log_null, Log_sql, Log_sqlite, Log_syslog, and Log_win.

Definition at line 241 of file Log.php.

    {
        return false;
    }

◆ crit()

Log::crit ( $message )

A convenience function for logging a critical event.

It will log a message at the PEAR_LOG_CRIT log level.

Parameters

mixed $message String or object containing the message to log.

Returns: boolean True if the message was successfully logged.

@access public

Since: Log 1.7.0

Definition at line 310 of file Log.php.

    {
        return $this->log($message, PEAR_LOG_CRIT);
    }

References log(), and PEAR_LOG_CRIT.

Here is the call graph for this function:

◆ debug()

Log::debug ( $message )

A convenience function for logging a debug event.

It will log a message at the PEAR_LOG_DEBUG log level.

Parameters

mixed $message String or object containing the message to log.

Returns: boolean True if the message was successfully logged.

@access public

Since: Log 1.7.0

Definition at line 395 of file Log.php.

    {
        return $this->log($message, PEAR_LOG_DEBUG);
    }

References log(), and PEAR_LOG_DEBUG.

Here is the call graph for this function:

◆ detach()

Log::detach ( $observer )

Removes a Log_observer instance from the list of observers.

Parameters

object	$observer	The Log_observer instance to detach from the list of listeners.
	boolean	True if the observer is successfully detached.

@access public

Since: Log 1.0

Definition at line 791 of file Log.php.

    {
        if (!is_a($observer, 'Log_observer') ||
            !isset($this->_listeners[$observer->_id])) {
            return false;
        }
 
        unset($this->_listeners[$observer->_id]);
 
        return true;
    }

◆ emerg()

Log::emerg ( $message )

A convenience function for logging a emergency event.

It will log a message at the PEAR_LOG_EMERG log level.

Parameters

mixed $message String or object containing the message to log.

Returns: boolean True if the message was successfully logged.

@access public

Since: Log 1.7.0

Definition at line 276 of file Log.php.

    {
        return $this->log($message, PEAR_LOG_EMERG);
    }

References log(), and PEAR_LOG_EMERG.

Here is the call graph for this function:

◆ err()

Log::err ( $message )

A convenience function for logging a error event.

It will log a message at the PEAR_LOG_ERR log level.

Parameters

mixed $message String or object containing the message to log.

Returns: boolean True if the message was successfully logged.

@access public

Since: Log 1.7.0

Definition at line 327 of file Log.php.

    {
        return $this->log($message, PEAR_LOG_ERR);
    }

References log(), and PEAR_LOG_ERR.

Here is the call graph for this function:

◆ factory()

& Log::factory	(	$handler,
		$name = `''`,
		$ident = `''`,
		$conf = `array()`,
		$level = `PEAR_LOG_DEBUG`
	)

Attempts to return a concrete Log instance of type $handler.

Parameters

string	$handler	The type of concrete Log subclass to return. Attempt to dynamically include the code for this subclass. Currently, valid values are 'console', 'syslog', 'sql', 'file', and 'mcal'.
string	$name	The name of the actually log file, table, or other specific store to use. Defaults to an empty string, with which the subclass will attempt to do something intelligent.
string	$ident	The identity reported to the log system.
array	$conf	A hash containing any additional configuration information that a subclass might need.
int	$level	Log messages up to and including this level.

Returns: object Log The newly created concrete Log instance, or null on an error. @access public

Since: Log 1.0

Definition at line 151 of file Log.php.

    {
        $handler = strtolower($handler);
        $class = 'Log_' . $handler;
        $classfile = 'Log/' . $handler . '.php';
 
        /*
         * Attempt to include our version of the named class, but don't treat
         * a failure as fatal.  The caller may have already included their own
         * version of the named class.
         */
        if (!Log::_classExists($class)) {
            include_once $classfile;
        }
 
        /* If the class exists, return a new instance of it. */
        if (Log::_classExists($class)) {
            $obj = new $class($name, $ident, $conf, $level);
            return $obj;
        }
 
        $null = null;
        return $null;
    }

References _classExists().

Referenced by singleton().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ flush()

Log::flush ( )

Abstract implementation of the flush() method.

Since: Log 1.8.2

Reimplemented in Log_composite, Log_console, Log_file, Log_firebug, and Log_mail.

Definition at line 250 of file Log.php.

    {
        return false;
    }

◆ getIdent()

Log::getIdent ( )

Returns the current identification string.

Returns: string The current Log instance's identification string.

@access public

Since: Log 1.6.3

Definition at line 854 of file Log.php.

    {
        return $this->_ident;
    }

References $_ident.

◆ getMask()

Log::getMask ( )

Returns the current level mask.

Returns: interger The current level mask.

@access public

Since: Log 1.7.0

Definition at line 710 of file Log.php.

    {
        return $this->_mask;
    }

References $_mask.

◆ getPriority()

Log::getPriority ( )

Returns the current default priority.

Returns: integer The current default priority.

@access public

Since: Log 1.8.4

Definition at line 739 of file Log.php.

    {
        return $this->_priority;
    }

References $_priority.

◆ info()

Log::info ( $message )

A convenience function for logging a information event.

It will log a message at the PEAR_LOG_INFO log level.

Parameters

mixed $message String or object containing the message to log.

Returns: boolean True if the message was successfully logged.

@access public

Since: Log 1.7.0

Definition at line 378 of file Log.php.

    {
        return $this->log($message, PEAR_LOG_INFO);
    }

References log(), and PEAR_LOG_INFO.

Here is the call graph for this function:

◆ isComposite()

Log::isComposite ( )

Indicates whether this is a composite class.

Returns: boolean True if this is a composite class.

@access public

Since: Log 1.0

Reimplemented in Log_composite.

Definition at line 828 of file Log.php.

    {
        return false;
    }

◆ log()

Log::log	(	$message,
		$priority = `null`
	)

Abstract implementation of the log() method.

Since: Log 1.0

Reimplemented in Log_composite, Log_console, Log_daemon, Log_display, Log_error_log, Log_file, Log_firebug, Log_mail, Log_mcal, Log_mdb2, Log_null, Log_sql, Log_sqlite, Log_syslog, and Log_win.

Definition at line 259 of file Log.php.

    {
        return false;
    }

Referenced by alert(), crit(), debug(), emerg(), err(), info(), notice(), and warning().

Here is the caller graph for this function:

◆ MASK()

Log::MASK ( $priority )

Calculate the log mask for the given priority.

This method may be called statically.

Parameters

integer $priority The priority whose mask will be calculated.

Returns: integer The calculated log mask.

@access public

Since: Log 1.7.0

Definition at line 623 of file Log.php.

    {
        return (1 << $priority);
    }

Referenced by _isMasked().

Here is the caller graph for this function:

◆ MAX()

Log::MAX ( $priority )

Calculate the log mask for all priorities less than or equal to the given priority.

In other words, $priority will be the highests priority matched by the resulting mask.

This method may be called statically.

Parameters

integer $priority The maximum priority covered by this mask.

Returns: integer The resulting log mask.

@access public

Since: Log 1.9.4

Definition at line 680 of file Log.php.

    {
        return ((1 << ($priority + 1)) - 1);
    }

Referenced by UPTO().

Here is the caller graph for this function:

◆ MIN()

Log::MIN ( $priority )

Calculate the log mask for all priorities greater than or equal to the given priority.

In other words, $priority will be the lowest priority matched by the resulting mask.

This method may be called statically.

Parameters

integer $priority The minimum priority covered by this mask.

Returns: integer The resulting log mask.

@access public

Since: Log 1.9.4

Definition at line 661 of file Log.php.

    {
        return PEAR_LOG_ALL ^ ((1 << $priority) - 1);
    }

References PEAR_LOG_ALL.

◆ notice()

Log::notice ( $message )

A convenience function for logging a notice event.

It will log a message at the PEAR_LOG_NOTICE log level.

Parameters

mixed $message String or object containing the message to log.

Returns: boolean True if the message was successfully logged.

@access public

Since: Log 1.7.0

Definition at line 361 of file Log.php.

    {
        return $this->log($message, PEAR_LOG_NOTICE);
    }

References log(), and PEAR_LOG_NOTICE.

Here is the call graph for this function:

◆ open()

Log::open ( )

Abstract implementation of the open() method.

Since: Log 1.0

Reimplemented in Log_composite, Log_console, Log_daemon, Log_display, Log_error_log, Log_file, Log_firebug, Log_mail, Log_mcal, Log_mdb2, Log_null, Log_sql, Log_sqlite, Log_syslog, and Log_win.

Definition at line 232 of file Log.php.

    {
        return false;
    }

◆ priorityToString()

Log::priorityToString ( $priority )

Returns the string representation of a PEAR_LOG_* integer constant.

Parameters

int $priority A PEAR_LOG_* integer constant.

Returns: string The string representation of $level.

@access public

Since: Log 1.0

Definition at line 566 of file Log.php.

    {
        $levels = array(
            PEAR_LOG_EMERG   => 'emergency',
            PEAR_LOG_ALERT   => 'alert',
            PEAR_LOG_CRIT    => 'critical',
            PEAR_LOG_ERR     => 'error',
            PEAR_LOG_WARNING => 'warning',
            PEAR_LOG_NOTICE  => 'notice',
            PEAR_LOG_INFO    => 'info',
            PEAR_LOG_DEBUG   => 'debug'
        );
 
        return $levels[$priority];
    }

References PEAR_LOG_ALERT, PEAR_LOG_CRIT, PEAR_LOG_DEBUG, PEAR_LOG_EMERG, PEAR_LOG_ERR, PEAR_LOG_INFO, PEAR_LOG_NOTICE, and PEAR_LOG_WARNING.

Referenced by _format(), and Log_win\log().

Here is the caller graph for this function:

◆ setIdent()

Log::setIdent ( $ident )

Sets this Log instance's identification string.

Parameters

string $ident The new identification string.

@access public

Since: Log 1.6.3

Reimplemented in Log_composite, Log_mdb2, and Log_sql.

Definition at line 841 of file Log.php.

    {
        $this->_ident = $ident;
    }

◆ setMask()

Log::setMask ( $mask )

Set and return the level mask for the current Log instance.

Parameters

integer $mask A bitwise mask of log levels.

Returns: integer The current level mask.

@access public

Since: Log 1.7.0

Definition at line 695 of file Log.php.

    {
        $this->_mask = $mask;
 
        return $this->_mask;
    }

References $_mask, and $mask.

◆ setPriority()

Log::setPriority ( $priority )

Sets the default priority to the specified value.

Parameters

integer $priority The new default priority.

@access public

Since: Log 1.8.4

Definition at line 752 of file Log.php.

    {
        $this->_priority = $priority;
    }

◆ singleton()

& Log::singleton	(	$handler,
		$name = `''`,
		$ident = `''`,
		$conf = `array()`,
		$level = `PEAR_LOG_DEBUG`
	)

Attempts to return a reference to a concrete Log instance of type $handler, only creating a new instance if no log instance with the same parameters currently exists.

You should use this if there are multiple places you might create a logger, you don't want to create multiple loggers, and you don't want to check for the existance of one each time. The singleton pattern does all the checking work for you.

You MUST call this method with the $var = &Log::singleton() syntax. Without the ampersand (&) in front of the method name, you will not get a reference, you will get a copy.

Parameters

string	$handler	The type of concrete Log subclass to return. Attempt to dynamically include the code for this subclass. Currently, valid values are 'console', 'syslog', 'sql', 'file', and 'mcal'.
string	$name	The name of the actually log file, table, or other specific store to use. Defaults to an empty string, with which the subclass will attempt to do something intelligent.
string	$ident	The identity reported to the log system.
array	$conf	A hash containing any additional configuration information that a subclass might need.
int	$level	Log messages up to and including this level.

Returns: object Log The newly created concrete Log instance, or null on an error. @access public

Since: Log 1.0

Definition at line 213 of file Log.php.

    {
        static $instances;
        if (!isset($instances)) $instances = array();
 
        $signature = serialize(array($handler, $name, $ident, $conf, $level));
        if (!isset($instances[$signature])) {
            $instances[$signature] = &Log::factory($handler, $name, $ident,
                                                   $conf, $level);
        }
 
        return $instances[$signature];
    }

References factory().

Referenced by Auth\_loadLogger().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ stringToPriority()

Log::stringToPriority ( $name )

Returns the the PEAR_LOG_* integer constant for the given string representation of a priority name.

This function performs a case-insensitive search.

Parameters

string $name String containing a priority name.

Returns: string The PEAR_LOG_* integer contstant corresponding the the specified priority name.

@access public

Since: Log 1.9.0

Definition at line 595 of file Log.php.

    {
        $levels = array(
            'emergency' => PEAR_LOG_EMERG,
            'alert'     => PEAR_LOG_ALERT,
            'critical'  => PEAR_LOG_CRIT,
            'error'     => PEAR_LOG_ERR,
            'warning'   => PEAR_LOG_WARNING,
            'notice'    => PEAR_LOG_NOTICE,
            'info'      => PEAR_LOG_INFO,
            'debug'     => PEAR_LOG_DEBUG
        );
 
        return $levels[strtolower($name)];
    }

References PEAR_LOG_ALERT, PEAR_LOG_CRIT, PEAR_LOG_DEBUG, PEAR_LOG_EMERG, PEAR_LOG_ERR, PEAR_LOG_INFO, PEAR_LOG_NOTICE, and PEAR_LOG_WARNING.

◆ UPTO()

Log::UPTO ( $priority )

Calculate the log mask for all priorities up to the given priority.

This method may be called statically.

Parameters

integer $priority The maximum priority covered by this mask.

Returns: integer The resulting log mask.

@access public

Since: Log 1.7.0

Deprecated:: deprecated since Log 1.9.4; use Log::MAX() instead

Definition at line 642 of file Log.php.

    {
        return Log::MAX($priority);
    }

References MAX().

Referenced by Log_console\Log_console(), Log_daemon\Log_daemon(), Log_display\Log_display(), Log_error_log\Log_error_log(), Log_file\Log_file(), Log_firebug\Log_firebug(), Log_mail\Log_mail(), Log_mcal\Log_mcal(), Log_mdb2\Log_mdb2(), Log_null\Log_null(), Log_sql\Log_sql(), Log_sqlite\Log_sqlite(), Log_syslog\Log_syslog(), and Log_win\Log_win().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ warning()

Log::warning ( $message )

A convenience function for logging a warning event.

It will log a message at the PEAR_LOG_WARNING log level.

Parameters

mixed $message String or object containing the message to log.

Returns: boolean True if the message was successfully logged.

@access public

Since: Log 1.7.0

Definition at line 344 of file Log.php.

    {
        return $this->log($message, PEAR_LOG_WARNING);
    }

References log(), and PEAR_LOG_WARNING.

Here is the call graph for this function:

Field Documentation

◆ $_formatMap

Log::$_formatMap

Initial value:

= array('%{timestamp}'  => '%1$s',
                            '%{ident}'      => '%2$s',
                            '%{priority}'   => '%3$s',
                            '%{message}'    => '%4$s',
                            '%{file}'       => '%5$s',
                            '%{line}'       => '%6$s',
                            '%{function}'   => '%7$s',
                            '%{class}'      => '%8$s',
                            '%\{'           => '%%{')

Definition at line 94 of file Log.php.

◆ $_id

Log::$_id = 0

Definition at line 53 of file Log.php.

◆ $_ident

Log::$_ident = ''

Definition at line 61 of file Log.php.

Referenced by getIdent().

◆ $_listeners

Log::$_listeners = array()

Definition at line 85 of file Log.php.

◆ $_mask

Log::$_mask = PEAR_LOG_ALL

Definition at line 77 of file Log.php.

Referenced by getMask(), and setMask().

◆ $_opened

Log::$_opened = false

Definition at line 45 of file Log.php.

Referenced by Log_composite\open(), Log_daemon\open(), Log_file\open(), Log_mail\open(), Log_mcal\open(), Log_mdb2\open(), Log_sql\open(), Log_sqlite\open(), Log_syslog\open(), and Log_win\open().

◆ $_priority

Log::$_priority = PEAR_LOG_INFO

Definition at line 69 of file Log.php.

Referenced by getPriority(), Log_composite\log(), Log_console\log(), Log_daemon\log(), Log_display\log(), Log_error_log\log(), Log_file\log(), Log_firebug\log(), Log_mail\log(), Log_mcal\log(), Log_mdb2\log(), Log_null\log(), Log_sql\log(), Log_sqlite\log(), Log_syslog\log(), and Log_win\log().

The documentation for this class was generated from the following file:

Services/PEAR/lib/Log.php

Public Member Functions

Data Fields

Detailed Description

Member Function Documentation

◆ _announce()

◆ _classExists()

◆ _extractMessage()

◆ _format()

◆ _getBacktraceVars()

◆ _isMasked()

◆ alert()

◆ attach()

◆ close()

◆ crit()

◆ debug()

◆ detach()

◆ emerg()

◆ err()

◆ factory()

◆ flush()

◆ getIdent()

◆ getMask()

◆ getPriority()

◆ info()

◆ isComposite()

◆ log()

◆ MASK()

◆ MAX()

◆ MIN()

◆ notice()

◆ open()

◆ priorityToString()

◆ setIdent()

◆ setMask()

◆ setPriority()

◆ singleton()

◆ stringToPriority()

◆ UPTO()

◆ warning()

Field Documentation

◆ $_formatMap

◆ $_id

◆ $_ident

◆ $_listeners

◆ $_mask

◆ $_opened

◆ $_priority