[TASK] Cleanup and deprecate TYPO3_DB occurrences
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Deprecation-78224-TYPO3_DBOccurrences.rst
1 .. include:: ../../Includes.txt
2
3 ==========================================
4 Deprecation: #78224 - TYPO3_DB occurrences
5 ==========================================
6
7 See :forge:`78224`
8
9 Description
10 ===========
11
12 The TYPO3_DB shorthand functionality has been removed for most of the TYPO3 Core PHP classes, excepted for the following locations:
13
14 * AbstractPlugin->databaseConnection (protected property)
15 * AbstractFunctionModule::getDatabaseConnection()
16 * BaseScriptClass::getDatabaseConnection()
17
18 For these occurrences extensions might extend the base functionality (e.g. for plugins or modules) and the call to the property and
19 protected methods still work.
20
21 Calling `$GLOBALS[TYPO3_DB]` is still possible but discouraged.
22
23
24 Impact
25 ======
26
27 Calling any of the methods above will trigger a deprecation log entry.
28
29
30 Affected Installations
31 ======================
32
33 Any TYPO3 instances with references to TYPO3_DB or references to the occurrences mentioned above.
34
35
36 Migration
37 =========
38
39 Use the ConnectionPool and the QueryBuilder classes to achieve future-proof and proper database abstraction for future TYPO3
40 versions.