TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,69 @@
+
+.. include:: /Includes.rst.txt
+
+.. _breaking-52705:
+
+=======================================================
+Breaking: #52705 - Default log configuration is changed
+=======================================================
+
+See :issue:`52705`
+
+Description
+===========
+
+FileWriter behavior has changed
+-------------------------------
+
+The FileWriter of the logging Framework now appends a hash to its default log file which is used when no log file name
+is provided in the configuration.
+
+The new default log file might now look like this (the hash depends on the current encryption key):
+
+::
+
+	typo3temp/logs/typo3_7ac500bce5.log
+
+
+Default configuration has changed
+---------------------------------
+
+For security reasons we want the default log file of TYPO3 to contain a random hash to make guessing the file name harder.
+
+Therefore the :code:`logFile` configuration is removed for the default :code:`FileWriter` configuration.
+
+Additionally the "deprecated" :code:`FileWriter` configuration is removed because it is not used by the core.
+
+
+
+Impact
+======
+
+If the log file configuration is **not** overwritten the TYPO3 default log file will change from
+:code:`typo3temp/logs/typo3.log` to :code:`typo3temp/logs/typo3_<hash>.log`.
+
+Installations with Extensions making use of the changed / removed log configurations might break.
+
+
+Affected Installations
+======================
+
+All instances that expect the default log file to be :code:`typo3temp/logs/typo3.log` for some reason.
+
+All instances that expect the :code:`logFile` configuration to be present in the :code:`writerConfiguration` for some reason.
+
+All instances that use the "deprecated" log configuration in their Extensions.
+
+All instances that use Extensions which extend the FileWriter and access the :code:`$defaultLogFile` class property
+which is replaced by :code:`$defaultLogFileTemplate` and the :code:`getDefaultLogFileName()` method.
+
+
+Migration
+=========
+
+Adjust the log configuration according to your needs in your :code:`LocalConfiguration.php`.
+
+Adjust any Extension code affected by the changes if needed.
+
+
+.. index:: PHP-API, LocalConfiguration