[TASK] Fix link in Changelog: Breaking-80929-TYPO3_DBMovedToExtension.rst
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 9.0 / Breaking-80929-TYPO3_DBMovedToExtension.rst
1 .. include:: ../../Includes.txt
2
3 ==============================================
4 Breaking: #80929 - TYPO3_DB moved to extension
5 ==============================================
6
7 See :issue:`80929`
8
9 Description
10 ===========
11
12 The legacy class :php:`DatabaseConnection` better known as :php:`$GLOBALS['TYPO3_DB']` has been moved
13 to the new system extension ext:typo3db_legacy.
14
15 The following classes have been moved and renamed, including an alias to the original class name:
16
17 * :php:`TYPO3\CMS\Core\Database\DatabaseConnection` to :php:`TYPO3\CMS\Typo3DbLegacy\Database\DatabaseConnection`
18 * :php:`TYPO3\CMS\Core\Database\PreparedStatement` to :php:`TYPO3\CMS\Typo3DbLegacy\Database\PreparedStatement`
19 * :php:`TYPO3\CMS\Core\Database\PostProcessQueryHookInterface` to :php:`TYPO3\CMS\Typo3DbLegacy\Database\PostProcessQueryHookInterface`
20 * :php:`TYPO3\CMS\Core\Database\PreProcessQueryHookInterface` to :php:`TYPO3\CMS\Typo3DbLegacy\Database\PreProcessQueryHookInterface`
21
22 Impact
23 ======
24
25 :php:`$GLOBALS['TYPO3_DB']` is no longer initialized by the core bootstrap. Third party extensions
26 that rely on :php:`$GLOBALS['TYPO3_DB']` will trigger a fatal error if :code:`ext:typo3db_legacy`
27 is not loaded.
28
29
30 Affected Installations
31 ======================
32
33 Installations with extensions which did not migrate to doctrine yet and need :php:`$GLOBALS['TYPO3_DB']`.
34
35
36 Migration
37 =========
38
39 `Migrate affected extensions to doctrine <https://docs.typo3.org/typo3cms/CoreApiReference/ApiOverview/Database/Migration/Index.html>`_
40 or load extension `typo3db_legacy` as backwards compatible layer to :php:`$GLOBALS['TYPO3_DB']`
41 (the extension is available via TER and may be installed from there or directly
42 via the upgrade wizard `typo3DbLegacyExtension`).
43
44 .. index:: Database, PHP-API, FullyScanned