W3cLogger
Extends \Joomla\CMS\Log\Logger\FormattedtextLoggerJoomla! W3C Logging class
This class is designed to build log files based on the W3C specification.
link | |
---|---|
since |
1.7.0 |
Methods
__construct
Constructor.
__construct(array &$options)
since |
3.0.1 |
---|
Arguments
- $options
array
__destruct
If deferred, write all pending logs.
__destruct()
since |
3.9.0 |
---|
addEntry
Method to add an entry to the log.
addEntry(\Joomla\CMS\Log\LogEntry $entry) : void
since |
3.0.1 |
---|---|
throws |
|
Arguments
- $entry
\Joomla\CMS\Log\LogEntry
The log entry object to add to the log.
formatLine
Format a line for the log file.
formatLine(\Joomla\CMS\Log\Logger\JLogEntry $entry) : String
since |
3.9.0 |
---|
Arguments
- $entry
\Joomla\CMS\Log\Logger\JLogEntry
The log entry to format as a string.
Response
String
generateFileHeader
Method to generate the log file header.
generateFileHeader() : string
since |
1.7.0 |
---|
Response
string
The log file header
initFile
Method to initialise the log file. This will create the folder path to the file if it doesn't already exist and also get a new file header if the file doesn't already exist. If the file already exists it will simply open it for writing.
initFile() : void
since |
1.7.0 |
---|---|
throws |
|
parseFields
Method to parse the format string into an array of fields.
parseFields() : void
since |
1.7.0 |
---|
Properties
format
The format which each entry follows in the log file.
All fields must be named in all caps and be within curly brackets eg. {FOOBAR}.
since |
1.7.0 |
---|
Type(s)
string
fields
The parsed fields from the format string.
since |
1.7.0 |
---|
Type(s)
array
path
The full filesystem path for the log file.
since |
1.7.0 |
---|
Type(s)
string
defer
If true, all writes will be deferred as long as possible.
NOTE: Deferred logs may never be written if the application encounters a fatal error.
since |
3.9.0 |
---|
Type(s)
boolean
deferredEntries
If deferring, entries will be stored here prior to writing.
since |
3.9.0 |
---|
Type(s)
array
options
Options array for the JLog instance.
since |
3.0.1 |
---|
Type(s)
array
priorities
Translation array for LogEntry priorities to text strings.
since |
3.0.1 |
---|
Type(s)
array