Formats incoming records into a one-line string. More...

Inheritance diagram for Monolog\Formatter\LineFormatter:

Collaboration diagram for Monolog\Formatter\LineFormatter:

Public Member Functions

__construct ($format=null, $dateFormat=null, $allowInlineLineBreaks=false, $ignoreEmptyContextAndExtra=false)

includeStacktraces ($include=true)

allowInlineLineBreaks ($allow=true)

ignoreEmptyContextAndExtra ($ignore=true)

format (array $record)

{{Formats a log record.

Parameters

array $record A record to format

Returns: mixed The formatted record

}} More...

formatBatch (array $records)

{{Formats a set of log records.

Parameters

array $records A set of records to format

Returns: mixed The formatted set of records

}} More...

stringify ($value)

Public Member Functions inherited from Monolog\Formatter\NormalizerFormatter

__construct ($dateFormat=null)

format (array $record)

{Formats a log record.

Parameters

array $record A record to format

Returns: mixed The formatted record

} More...

formatBatch (array $records)

{Formats a set of log records.

Parameters

array $records A set of records to format

Returns: mixed The formatted set of records

} More...

detectAndCleanUtf8 (&$data)

Detect invalid UTF-8 string characters and convert to valid UTF-8. More...

format (array $record)

Formats a log record. More...

formatBatch (array $records)

Formats a set of log records. More...

Data Fields
const	SIMPLE_FORMAT = "[%datetime%] %channel%.%level_name%: %message% %context% %extra%\n"

Data Fields inherited from Monolog\Formatter\NormalizerFormatter
const	SIMPLE_DATE = "Y-m-d H:i:s"

Protected Member Functions
	normalizeException ($e)

	convertToString ($data)

	replaceNewlines ($str)

Protected Member Functions inherited from Monolog\Formatter\NormalizerFormatter
	normalize ($data, $depth=0)

	normalizeException ($e)

	toJson ($data, $ignoreErrors=false)
	Return the JSON representation of a value. More...

Protected Attributes
	$format

	$allowInlineLineBreaks

	$ignoreEmptyContextAndExtra

	$includeStacktraces

Protected Attributes inherited from Monolog\Formatter\NormalizerFormatter
	$dateFormat

Detailed Description

Formats incoming records into a one-line string.

This is especially useful for logging to files

Author: Jordi Boggiano j.bog.nosp@m.gian.nosp@m.o@sel.nosp@m.d.be; Christophe Coevoet stof@.nosp@m.notk.nosp@m..org

Definition at line 24 of file LineFormatter.php.

Constructor & Destructor Documentation

◆ __construct()

Monolog\Formatter\LineFormatter::__construct	(	$format = `null`,
		$dateFormat = `null`,
		$allowInlineLineBreaks = `false`,
		$ignoreEmptyContextAndExtra = `false`
	)

Parameters

string	$format	The format of the message
string	$dateFormat	The format of the timestamp: one supported by DateTime::format
bool	$allowInlineLineBreaks	Whether to allow inline line breaks in log entries
bool	$ignoreEmptyContextAndExtra

Definition at line 39 of file LineFormatter.php.

    {
        $this->format = $format ?: static::SIMPLE_FORMAT;
        $this->allowInlineLineBreaks = $allowInlineLineBreaks;
        $this->ignoreEmptyContextAndExtra = $ignoreEmptyContextAndExtra;
        parent::__construct($dateFormat);
    }

References Monolog\Formatter\LineFormatter\$allowInlineLineBreaks, Monolog\Formatter\NormalizerFormatter\$dateFormat, Monolog\Formatter\LineFormatter\$format, Monolog\Formatter\LineFormatter\$ignoreEmptyContextAndExtra, Monolog\Formatter\LineFormatter\allowInlineLineBreaks(), Monolog\Formatter\LineFormatter\format(), and Monolog\Formatter\LineFormatter\ignoreEmptyContextAndExtra().

Here is the call graph for this function:

Member Function Documentation

◆ allowInlineLineBreaks()

Monolog\Formatter\LineFormatter::allowInlineLineBreaks ( $allow = true )

Definition at line 55 of file LineFormatter.php.

    {
        $this->allowInlineLineBreaks = $allow;
    }

References Monolog\Formatter\LineFormatter\allowInlineLineBreaks().

Referenced by Monolog\Formatter\LineFormatter\__construct(), Monolog\Formatter\LineFormatter\allowInlineLineBreaks(), Monolog\Formatter\LineFormatter\includeStacktraces(), and Monolog\Formatter\LineFormatter\replaceNewlines().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ convertToString()

Monolog\Formatter\LineFormatter::convertToString ( $data )

protected

Definition at line 152 of file LineFormatter.php.

    {
        if (null === $data || is_bool($data)) {
            return var_export($data, true);
        }
 
        if (is_scalar($data)) {
            return (string) $data;
        }
 
        if (version_compare(PHP_VERSION, '5.4.0', '>=')) {
            return $this->toJson($data, true);
        }
 
        return str_replace('\\/', '/', @json_encode($data));
    }

References $data, and Monolog\Formatter\NormalizerFormatter\toJson().

Referenced by Monolog\Formatter\LineFormatter\stringify().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ format()

Monolog\Formatter\LineFormatter::format ( array $record )

{{Formats a log record.

Parameters

array $record A record to format

Returns: mixed The formatted record

}}

Reimplemented from Monolog\Formatter\NormalizerFormatter.

Reimplemented in ilLineFormatter.

Definition at line 68 of file LineFormatter.php.

    {
        $vars = parent::format($record);
 
        $output = $this->format;
 
        foreach ($vars['extra'] as $var => $val) {
            if (false !== strpos($output, '%extra.'.$var.'%')) {
                $output = str_replace('%extra.'.$var.'%', $this->stringify($val), $output);
                unset($vars['extra'][$var]);
            }
        }
 
 
        foreach ($vars['context'] as $var => $val) {
            if (false !== strpos($output, '%context.'.$var.'%')) {
                $output = str_replace('%context.'.$var.'%', $this->stringify($val), $output);
                unset($vars['context'][$var]);
            }
        }
 
        if ($this->ignoreEmptyContextAndExtra) {
            if (empty($vars['context'])) {
                unset($vars['context']);
                $output = str_replace('%context%', '', $output);
            }
 
            if (empty($vars['extra'])) {
                unset($vars['extra']);
                $output = str_replace('%extra%', '', $output);
            }
        }
 
        foreach ($vars as $var => $val) {
            if (false !== strpos($output, '%'.$var.'%')) {
                $output = str_replace('%'.$var.'%', $this->stringify($val), $output);
            }
        }
 
        // remove leftover %extra.xxx% and %context.xxx% if any
        if (false !== strpos($output, '%')) {
            $output = preg_replace('/%(?:extra|context)\..+?%/', '', $output);
        }
 
        return $output;
    }

References Monolog\Formatter\LineFormatter\$format, Sabre\VObject\$output, and Monolog\Formatter\LineFormatter\ignoreEmptyContextAndExtra().

Referenced by Monolog\Formatter\LineFormatter\__construct(), and Monolog\Formatter\LineFormatter\formatBatch().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ formatBatch()

Monolog\Formatter\LineFormatter::formatBatch ( array $records )

{{Formats a set of log records.

Parameters

array $records A set of records to format

Returns: mixed The formatted set of records

}}

Reimplemented from Monolog\Formatter\NormalizerFormatter.

Definition at line 115 of file LineFormatter.php.

    {
        $message = '';
        foreach ($records as $record) {
            $message .= $this->format($record);
        }
 
        return $message;
    }

References $message, $records, and Monolog\Formatter\LineFormatter\format().

Here is the call graph for this function:

◆ ignoreEmptyContextAndExtra()

Monolog\Formatter\LineFormatter::ignoreEmptyContextAndExtra ( $ignore = true )

Definition at line 60 of file LineFormatter.php.

    {
        $this->ignoreEmptyContextAndExtra = $ignore;
    }

References $ignore, and Monolog\Formatter\LineFormatter\ignoreEmptyContextAndExtra().

Referenced by Monolog\Formatter\LineFormatter\__construct(), Monolog\Formatter\LineFormatter\format(), and Monolog\Formatter\LineFormatter\ignoreEmptyContextAndExtra().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ includeStacktraces()

Monolog\Formatter\LineFormatter::includeStacktraces ( $include = true )

Definition at line 47 of file LineFormatter.php.

    {
        $this->includeStacktraces = $include;
        if ($this->includeStacktraces) {
            $this->allowInlineLineBreaks = true;
        }
    }

References Monolog\Formatter\LineFormatter\allowInlineLineBreaks(), and Monolog\Formatter\LineFormatter\includeStacktraces().

Referenced by Monolog\Formatter\LineFormatter\includeStacktraces(), and Monolog\Formatter\LineFormatter\normalizeException().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ normalizeException()

Monolog\Formatter\LineFormatter::normalizeException ( $e )

protected

Reimplemented from Monolog\Formatter\NormalizerFormatter.

Definition at line 130 of file LineFormatter.php.

    {
        // TODO 2.0 only check for Throwable
        if (!$e instanceof \Exception && !$e instanceof \Throwable) {
            throw new \InvalidArgumentException('Exception/Throwable expected, got '.gettype($e).' / '.Utils::getClass($e));
        }
 
        $previousText = '';
        if ($previous = $e->getPrevious()) {
            do {
                $previousText .= ', '.Utils::getClass($previous).'(code: '.$previous->getCode().'): '.$previous->getMessage().' at '.$previous->getFile().':'.$previous->getLine();
            } while ($previous = $previous->getPrevious());
        }
 
        $str = '[object] ('.Utils::getClass($e).'(code: '.$e->getCode().'): '.$e->getMessage().' at '.$e->getFile().':'.$e->getLine().$previousText.')';
        if ($this->includeStacktraces) {
            $str .= "\n[stacktrace]\n".$e->getTraceAsString()."\n";
        }
 
        return $str;
    }

References Monolog\Utils\getClass(), and Monolog\Formatter\LineFormatter\includeStacktraces().

Here is the call graph for this function:

◆ replaceNewlines()

Monolog\Formatter\LineFormatter::replaceNewlines ( $str )

protected

Definition at line 169 of file LineFormatter.php.

    {
        if ($this->allowInlineLineBreaks) {
            if (0 === strpos($str, '{')) {
                return str_replace(array('\r', '\n'), array("\r", "\n"), $str);
            }
 
            return $str;
        }
 
        return str_replace(array("\r\n", "\r", "\n"), ' ', $str);
    }

References Monolog\Formatter\LineFormatter\allowInlineLineBreaks().

Referenced by Monolog\Formatter\LineFormatter\stringify().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ stringify()

Monolog\Formatter\LineFormatter::stringify ( $value )

Definition at line 125 of file LineFormatter.php.

    {
        return $this->replaceNewlines($this->convertToString($value));
    }

References Monolog\Formatter\LineFormatter\convertToString(), and Monolog\Formatter\LineFormatter\replaceNewlines().

Here is the call graph for this function:

Field Documentation

◆ $allowInlineLineBreaks

Monolog\Formatter\LineFormatter::$allowInlineLineBreaks

protected

Definition at line 29 of file LineFormatter.php.

Referenced by Monolog\Formatter\LineFormatter\__construct().

◆ $format

Monolog\Formatter\LineFormatter::$format

protected

Definition at line 28 of file LineFormatter.php.

Referenced by Monolog\Formatter\LineFormatter\__construct(), and Monolog\Formatter\LineFormatter\format().

◆ $ignoreEmptyContextAndExtra

Monolog\Formatter\LineFormatter::$ignoreEmptyContextAndExtra

protected

Definition at line 30 of file LineFormatter.php.

Referenced by Monolog\Formatter\LineFormatter\__construct().

◆ $includeStacktraces

Monolog\Formatter\LineFormatter::$includeStacktraces

protected

Definition at line 31 of file LineFormatter.php.

◆ SIMPLE_FORMAT

const Monolog\Formatter\LineFormatter::SIMPLE_FORMAT = "[%datetime%] %channel%.%level_name%: %message% %context% %extra%\n"

Definition at line 26 of file LineFormatter.php.

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

libs/composer/vendor/monolog/monolog/src/Monolog/Formatter/LineFormatter.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ allowInlineLineBreaks()

◆ convertToString()

◆ format()

◆ formatBatch()

◆ ignoreEmptyContextAndExtra()

◆ includeStacktraces()

◆ normalizeException()

◆ replaceNewlines()

◆ stringify()

Field Documentation

◆ $allowInlineLineBreaks

◆ $format

◆ $ignoreEmptyContextAndExtra

◆ $includeStacktraces

◆ SIMPLE_FORMAT