[FOLLOWUP][DOCS] 8.4 Documentation Part 1/2
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 8.4 / Deprecation-78193-ExtensionManagementUtilityextRelPath.rst
1 .. include:: ../../Includes.txt
2
3 ==============================================================
4 Deprecation: #78193 - ExtensionManagementUtility::extRelPath()
5 ==============================================================
6
7 See :issue:`78193`
8
9 Description
10 ===========
11
12 The method :php:`ExtensionManagementUtility::extRelPath()` for resolving paths relative to the current script has been marked as deprecated.
13
14
15 Impact
16 ======
17
18 Calling :php:`ExtensionManagementUtility::extRelPath()` will trigger a deprecation log entry.
19
20
21 Affected Installations
22 ======================
23
24 Any TYPO3 instance with extensions or third-party scripts resolving paths with the method above.
25
26
27 Migration
28 =========
29
30 Use alternatives for resolving paths. There are the following methods available:
31 * :php:`ExtensionManagementUtility::extPath()` - to resolve the full path of an extension
32 * :php:`ExtensionManagementUtility::siteRelPath()` - to resolve the location of an extension relative to `PATH_site`
33 * :php:`GeneralUtility::getFileAbsFileName()` - to resolve a file/path prefixed with `EXT:myext`
34 * :php:`PathUtility::getAbsoluteWebPath()` - used for output a file location (previously resolved with :php:`GeneralUtility::getFileAbsFileName()`) that is absolutely prefixed for the web folder
35
36 .. index:: PHP-API