FileWriterTest.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * 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!
 */
 
namespace ‪TYPO3\CMS\Core\Tests\Unit\Log\Writer;
 
use org\bovigo\vfs\vfsStream;
use org\bovigo\vfs\vfsStreamWrapper;
use ‪TYPO3\CMS\Core\Log\Logger;
use ‪TYPO3\CMS\Core\Log\LogLevel;
use ‪TYPO3\CMS\Core\Log\LogManager;
use ‪TYPO3\CMS\Core\Log\LogRecord;
use ‪TYPO3\CMS\Core\Log\Writer\FileWriter;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use ‪TYPO3\CMS\Core\Utility\StringUtility;
use TYPO3\TestingFramework\Core\Unit\UnitTestCase;
 
class ‪FileWriterTest extends UnitTestCase
{
    protected string ‪$logFileDirectory = 'Log';
    protected string ‪$logFileName = 'test.log';
 
    protected function ‪setUpVfsStream(): void
    {
        vfsStream::setup('LogRoot');
    }
 
    protected function ‪createLogger(string $name = ''): ‪Logger
    {
        if (empty($name)) {
            $name = ‪StringUtility::getUniqueId('test.core.log.');
        }
        GeneralUtility::makeInstance(LogManager::class)->registerLogger($name);
        $logger = GeneralUtility::makeInstance(LogManager::class)->getLogger($name);
        return $logger;
    }
 
    protected function ‪createWriter(string $prependName = ''): ‪FileWriter
    {
        $writer = GeneralUtility::makeInstance(FileWriter::class, [
            'logFile' => $this->‪getDefaultFileName($prependName),
        ]);
        return $writer;
    }
 
    protected function ‪getDefaultFileName($prependName = ''): string
    {
        return 'vfs://LogRoot/' . $this->logFileDirectory . '/' . $prependName . ‪$this->logFileName;
    }
 
    public function ‪setLogFileSetsLogFile(): void
    {
        $this->‪setUpVfsStream();
        vfsStream::newFile($this->logFileName)->at(vfsStreamWrapper::getRoot());
        $writer = GeneralUtility::makeInstance(FileWriter::class);
        $writer->setLogFile($this->‪getDefaultFileName());
        self::assertEquals($this->‪getDefaultFileName(), $writer->getLogFile());
    }
 
    public function ‪setLogFileAcceptsAbsolutePath(): void
    {
        $writer = GeneralUtility::makeInstance(FileWriter::class);
        $tempFile = rtrim(sys_get_temp_dir(), '/\\') . '/typo3.log';
        $writer->setLogFile($tempFile);
        self::assertEquals($tempFile, $writer->getLogFile());
    }
 
    public function ‪createsLogFileDirectory(): void
    {
        $this->‪setUpVfsStream();
        $this->‪createWriter();
        self::assertTrue(vfsStreamWrapper::getRoot()->hasChild($this->logFileDirectory));
    }
 
    public function ‪createsLogFile(): void
    {
        $this->‪setUpVfsStream();
        $this->‪createWriter();
        self::assertTrue(vfsStreamWrapper::getRoot()->getChild($this->logFileDirectory)->hasChild($this->logFileName));
    }
 
    public function ‪logsToFileDataProvider(): array
    {
        $simpleRecord = GeneralUtility::makeInstance(LogRecord::class, ‪StringUtility::getUniqueId('test.core.log.fileWriter.simpleRecord.'), LogLevel::INFO, 'test record');
        $recordWithData = GeneralUtility::makeInstance(LogRecord::class, ‪StringUtility::getUniqueId('test.core.log.fileWriter.recordWithData.'), LogLevel::ALERT, 'test record with data', ['foo' => ['bar' => 'baz']]);
        return [
            'simple record' => [$simpleRecord, trim((string)$simpleRecord)],
            'record with data' => [$recordWithData, trim((string)$recordWithData)],
        ];
    }
 
    public function ‪logsToFile(‪LogRecord $record, string $expectedResult): void
    {
        $this->‪setUpVfsStream();
        $this->‪createWriter()->‪writeLog($record);
        $logFileContents = trim(file_get_contents($this->‪getDefaultFileName()));
        self::assertEquals($expectedResult, $logFileContents);
    }
 
    public function ‪logsToFileWithUnescapedCharacters(): void
    {
        $this->‪setUpVfsStream();
 
        $recordWithData = GeneralUtility::makeInstance(
            LogRecord::class,
            ‪StringUtility::getUniqueId('test.core.log.fileWriter.recordWithData.'),
            LogLevel::INFO,
            'test record with unicode and slash in data to encode',
            ['foo' => ['bar' => 'I paid 0.00€ for open source projects/code']]
        );
 
        $expectedResult = '{"foo":{"bar":"I paid 0.00€ for open source projects/code"}}';
 
        $this->‪createWriter('encoded-data')->‪writeLog($recordWithData);
        $logFileContents = trim(file_get_contents($this->‪getDefaultFileName('encoded-data')));
        self::assertStringContainsString($expectedResult, $logFileContents);
    }
 
    public function ‪differentWritersLogToDifferentFiles(‪LogRecord $record, string $expectedResult): void
    {
        $this->‪setUpVfsStream();
        $firstWriter = $this->‪createWriter();
        $secondWriter = $this->‪createWriter('second-');
 
        $firstWriter->writeLog($record);
        $secondWriter->writeLog($record);
 
        $firstLogFileContents = trim(file_get_contents($this->‪getDefaultFileName()));
        $secondLogFileContents = trim(file_get_contents($this->‪getDefaultFileName('second-')));
 
        self::assertEquals($expectedResult, $firstLogFileContents);
        self::assertEquals($expectedResult, $secondLogFileContents);
    }
 
    public function ‪aSecondLogWriterToTheSameFileDoesNotOpenTheFileTwice(): void
    {
        $this->‪setUpVfsStream();
 
        $firstWriter = $this->getMockBuilder(FileWriter::class)
            ->addMethods(['dummy'])
            ->getMock();
        $secondWriter = $this->getMockBuilder(FileWriter::class)
            ->onlyMethods(['createLogFile'])
            ->getMock();
 
        $secondWriter->expects(self::never())->method('createLogFile');
 
        $logFilePrefix = ‪StringUtility::getUniqueId('unique');
        $firstWriter->setLogFile($this->‪getDefaultFileName($logFilePrefix));
        $secondWriter->setLogFile($this->‪getDefaultFileName($logFilePrefix));
    }
 
    public function ‪fileHandleIsNotClosedIfSecondFileWriterIsStillUsingSameFile(): void
    {
        $this->‪setUpVfsStream();
 
        $firstWriter = $this->getMockBuilder(FileWriter::class)
            ->onlyMethods(['closeLogFile'])
            ->getMock();
        $secondWriter = $this->getMockBuilder(FileWriter::class)
            ->onlyMethods(['closeLogFile'])
            ->getMock();
 
        $firstWriter->expects(self::never())->method('closeLogFile');
        $secondWriter->expects(self::once())->method('closeLogFile');
 
        $logFilePrefix = ‪StringUtility::getUniqueId('unique');
        $firstWriter->setLogFile($this->‪getDefaultFileName($logFilePrefix));
        $secondWriter->setLogFile($this->‪getDefaultFileName($logFilePrefix));
        $firstWriter->__destruct();
        $secondWriter->__destruct();
    }
}