[!!!][TASK] Use native trigger_error and ErrorHandler for deprecations
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Deprecation-82438-DeprecationMethods.rst
1 .. include:: ../../Includes.txt
2
3 =========================================
4 Deprecation: #82438 - Deprecation methods
5 =========================================
6
7 See :issue:`82438`
8
9 Description
10 ===========
11
12 The deprecation log related methods from GeneralUtility along with a
13 related configuration option have been deprecated:
14
15 * GeneralUtility::logDeprecatedFunction()
16 * GeneralUtility::deprecationLog()
17 * GeneralUtility::getDeprecationLogFileName()
18 * GeneralUtility::logDeprecatedViewHelperAttribute()
19 * $GLOBALS['TYPO3_CONF_VARS']['SYS']['enableDeprecationLog'] has no effect anymore
20
21 Deprecations now use PHP method :php:`trigger_error('a message', E_USER_DEPRECATED)` and run
22 through the logging and exception stack of the TYPO3 core.  In development context deprecations
23 are turned into exceptions by default and ignored in production context.
24
25
26 Impact
27 ======
28
29 The file :file:`typo3conf/deprecation_xy.log` is no longer filled by the core. However, if an
30 extension still uses methods like :php:`GeneralUtility::logDeprecatedFunction()` it is
31 still filled with these messages, and throws an additional PHP E_USER_DEPRECATED message.
32
33
34 Affected Installations
35 ======================
36
37 Installations with extensions that use one of the above methods.
38
39
40 Migration
41 =========
42
43 Extension authors should switch to :php:`trigger_error('A useful message', E_USER_DEPRECATED);`
44
45 .. index:: PHP-API, FullyScanned