[TASK] Fixed links to issues in Changelog
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Deprecation-94272-DeprecatedApplication-runCallback.rst
1 .. include:: ../../Includes.txt
2
3 ==========================================================
4 Deprecation: #94272 - Deprecated Application->run callback
5 ==========================================================
6
7 See :issue:`94272`
8
9 Description
10 ===========
11
12 Since the introduction of the :php:`ApplicationInterface` in :issue:`67808`
13 (TYPO3 v7), which serves as a wrapper for setting up the bootstrap and
14 calling the request, it was possible to run either the console, the frontend
15 or the backend by calling :php:`run()` on the corresponding Application class.
16
17 The :php:`run()` method also featured the possibility to provide a :php:`callback`
18 as first argument. This was mainly introduced, because no proper solution for
19 subrequests existed at this time. Since :issue:`83725`, the callback is not
20 longer necessary as such functionality can be handled by a PSR-15
21 middleware.
22
23 Therefore, the :php:`$execute` argument of :php:`ApplicationInterface->run()`
24 has been deprecated and will be removed in v12.
25
26 Impact
27 ======
28
29 Calling :php:`ApplicationInterface->run()` with the first argument
30 :php:`$execute` set, will log a deprecation warning and the argument
31 will be removed in v12.
32
33 Affected Installations
34 ======================
35
36 All installations which manually call :php:`ApplicationInterface->run()`,
37 while providing a :php:`callback` as first argument. The extension scanner
38 will find those usages as weak match.
39
40 Migration
41 =========
42
43 All places in custom extension code, calling this method with the first
44 argument set, which is rather unlikely, needs to be adapted. Therefore,
45 you can use PSR-15 middlewares instead. Since console commands do not
46 feature PSR-15 middlewares, you have to replace the :php:`callback` with
47 separate chained post-processing commands.
48
49 .. index:: CLI, PHP-API, FullyScanned, ext:core