[TASK] Deprecate eID registration with a script to a file
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Deprecation-85646-DeprecateEIDImplementedAsScript.rst
1 .. include:: ../../Includes.txt
2
3 =========================================================
4 Deprecation: #85646 - Deprecate eID implemented as script
5 =========================================================
6
7 See :issue:`85646`
8
9 Description
10 ===========
11
12 Calling a frontend eID as a direct script call has been deprecated.
13
14 Setting a PHP eID include like this logs deprecation warnings::
15
16     $GLOBALS['TYPO3_CONF_VARS']['FE']['eID_include']['myEid'] = 'EXT:myExt/Resources/Php/MyAjax.php';
17
18 This is not valid anymore. Instead, a class / method combination should be used::
19
20     $GLOBALS['TYPO3_CONF_VARS']['FE']['eID_include']['myEid'] = \MyVendor\MyExt\Controller\MyEidController::class . '::myMethod';
21
22 The main difference is that a script call does not execute code if calling :php:`require()` on
23 it directly anymore, but needs a proper registration including an entry method to be called.
24 This increases encapsulation and security.
25
26 Impact
27 ======
28
29 eIDs which are registered with a direct script includes log a deprecation message.
30
31
32 Affected Installations
33 ======================
34
35 3rd party extensions which implement eIDs with a script to a file instead of
36 a class->method combination.
37
38
39 Migration
40 =========
41
42 Register eID with a class::method syntax like :php:`\TYPO3\CMS\Frontend\MyClass::mymethod` instead.
43
44 .. index:: Frontend, NotScanned