LogRecord.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Core\Log;

/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */

use TYPO3\CMS\Core\Core\Bootstrap;

class LogRecord implements \ArrayAccess
{
    protected $requestId = '';

    protected $created = 0.0;

    protected $component = '';

    protected $level = LogLevel::INFO;

    protected $message = '';

    protected $data = [];

    private $gettableProperties = [
        'requestId',
        'created',
        'component',
        'level',
        'message',
        'data'
    ];

    private $settableProperties = [
        'level',
        'message',
        'data'
    ];

    public function __construct($component = '', $level, $message, array $data = [])
    {
        $this->setRequestId(Bootstrap::getInstance()->getRequestId())
            ->setCreated(microtime(true))
            ->setComponent($component)
            ->setLevel($level)
            ->setMessage($message)
            ->setData($data);
    }

    public function setComponent($component)
    {
        $this->component = $component;
        return $this;
    }

    public function getComponent()
    {
        return $this->component;
    }

    public function setCreated($created)
    {
        $this->created = $created;
        return $this;
    }

    public function getCreated()
    {
        return $this->created;
    }

    public function setLevel($level)
    {
        LogLevel::validateLevel($level);
        $this->level = $level;
        return $this;
    }

    public function getLevel()
    {
        return $this->level;
    }

    public function setData($data)
    {
        $this->data = $data;
        return $this;
    }

    public function getData()
    {
        return $this->data;
    }

    public function addData(array $data)
    {
        $this->data = array_merge($this->data, $data);
        return $this;
    }

    public function setMessage($message)
    {
        $this->message = (string)$message;
        return $this;
    }

    public function getMessage()
    {
        return $this->message;
    }

    public function setRequestId($requestId)
    {
        $this->requestId = $requestId;
        return $this;
    }

    public function getRequestId()
    {
        return $this->requestId;
    }

    public function __toString()
    {
        $timestamp = date('r', (int)$this->created);
        $levelName = LogLevel::getName($this->level);
        $data = '';
        if (!empty($this->data)) {
            // According to PSR3 the exception-key may hold an \Exception
            // Since json_encode() does not encode an exception, we run the _toString() here
            if (isset($this->data['exception']) && $this->data['exception'] instanceof \Exception) {
                $this->data['exception'] = (string)$this->data['exception'];
            }
            $data = '- ' . json_encode($this->data);
        }
        $logRecordString = sprintf(
            '%s [%s] request="%s" component="%s": %s %s',
            $timestamp,
            $levelName,
            $this->requestId,
            $this->component,
            $this->message,
            $data
        );
        return $logRecordString;
    }

    public function toArray()
    {
        return [
            'requestId' => $this->requestId,
            'created' => $this->created,
            'component' => $this->component,
            'level' => $this->level,
            'message' => $this->message,
            'data' => $this->data
        ];
    }

    public function offsetExists($offset)
    {
        $offsetExists = false;
        if (in_array($offset, $this->gettableProperties, true) && isset($this->{$offset})) {
            $offsetExists = true;
        }
        return $offsetExists;
    }

    public function offsetGet($offset)
    {
        if (!in_array($offset, $this->gettableProperties, true)) {
            return null;
        }
        return $this->{$offset};
    }

    public function offsetSet($offset, $value)
    {
        if (in_array($offset, $this->settableProperties, true)) {
            $this->{$offset} = $offset;
        }
    }

    public function offsetUnset($offset)
    {
        if (in_array($offset, $this->settableProperties, true)) {
            unset($this->{$offset});
        }
    }
}