Skip to content

Commit 9426347

Browse files
authored
[!!!][TASK] Remove legacy BE entry point handling #1147 (#5036)
Resolves: TYPO3-Documentation/Changelog-To-Doc#1147 Releases: main
1 parent e60f4dd commit 9426347

File tree

6 files changed

+20
-42
lines changed

6 files changed

+20
-42
lines changed

Documentation/ApiOverview/Autoloading/Index.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ Loading classes without Composer mode
9595

9696
This means, you did not install TYPO3 via a `require` statement inside your
9797
:file:`composer.json`. It's a regular old-school install where the TYPO3 source
98-
and the symlinks (:file:`typo3/index.php`) are setup manually.
98+
and the symlinks (:file:`index.php`) are setup manually.
9999

100100
In this case, every time you install an extension, the autoloader scans the
101101
whole extension directory for classes. No matter if they follow any convention

Documentation/ApiOverview/DirectoryStructure/Index.rst

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -219,13 +219,12 @@ another folder name than :file:`fileadmin/` can be in use.
219219
:file:`public/typo3/`
220220
~~~~~~~~~~~~~~~~~~~~~
221221

222-
This directory contains the two PHP files for accessing the TYPO3
223-
backend (:file:`typo3/index.php`) and install tool (:file:`typo3/install.php`).
222+
If :composer:`typo3/cms-install` is installed, this directory contains the PHP
223+
file for accessing the install tool (:file:`public/typo3/install.php`).
224224

225-
.. versionchanged:: 12.0
226-
Starting with TYPO3 v12 (or v11 using `typo3/cms-composer-installers` v4)
227-
the system extensions are not located in this directory anymore. They can now
228-
be found in the :ref:`directory-vendor` folder.
225+
.. versionchanged:: 14.0
226+
The TYPO3 backend entry point PHP file :file:`public/typo3/index.php` has
227+
been removed. The backend can be accessed via the :ref:`backend-entry-point`.
229228

230229
.. _directory-public-typo3temp:
231230

Documentation/ApiOverview/DirectoryStructure/LegacyInstallations.rst

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,8 +54,12 @@ structure.
5454
:file:`typo3/`
5555
--------------
5656

57-
Among others, this directory contains the two PHP files for accessing the TYPO3
58-
backend (:file:`typo3/index.php`) and install tool (:file:`typo3/install.php`).
57+
Among others, this directory contains the PHP
58+
file for accessing the install tool (:file:`public/typo3/install.php`).
59+
60+
.. versionchanged:: 14.0
61+
The TYPO3 backend entry point PHP file :file:`typo3/index.php` has
62+
been removed. The backend can be accessed via the :ref:`backend-entry-point`.
5963

6064

6165
.. _legacy-directory-typo3-sysext:

Documentation/ApiOverview/RequestLifeCycle/Bootstrapping.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,7 @@ to have an overview of these base values, it is worth taking a look into the fol
124124

125125
- :php:`SystemEnvironmentBuilder::calculateScriptPath()` calculates the script
126126
path. This is the absolute path to the entry script. This can be something
127-
like '.../public/index.php' or '.../public/typo3/index.php' for web calls,
127+
like '.../public/index.php' for web calls,
128128
or '.../bin/typo3' or similar for CLI calls.
129129

130130
- :php:`SystemEnvironmentBuilder::initializeGlobalVariables()` sets

Documentation/CodingGuidelines/CodingBestPractices/NamedArguments.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -240,7 +240,7 @@ developers often overlook argument positions and names:
240240
[
241241
'RewriteCond %{REQUEST_FILENAME} !-d',
242242
'RewriteCond %{REQUEST_FILENAME} !-l',
243-
'RewriteRule ^typo3/(.*)$ %{ENV:CWD}typo3/index.php [QSA,L]',
243+
'RewriteRule ^typo3/(.*)$ %{ENV:CWD}index.php [QSA,L]',
244244
]
245245
))),
246246
replacement: 'RewriteRule ^typo3/(.*)$ %{ENV:CWD}index.php [QSA,L]',

Documentation/Configuration/BackendEntryPoint/Index.rst

Lines changed: 6 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -12,12 +12,14 @@ Backend entry point
1212

1313
.. versionadded:: 13.0
1414
Before TYPO3 v13 the backend entry point path for accessing the backend has
15-
always been :samp:`/typo3`. Since TYPO3 v13 the backend entry point can be
15+
always been :path:`/typo3`. Since TYPO3 v13 the backend entry point can be
1616
adjusted to something else. See :ref:`backend-entry-point-configuration`
1717
and :ref:`backend-entry-point-migration`.
1818

19-
The legacy entry point :samp:`/typo3/index.php` is no longer needed and
20-
therefore deprecated. See :ref:`backend-entry-point-legacy-free`.
19+
.. versionchanged:: 14.0
20+
21+
The legacy entry point :file:`/typo3/index.php` is no longer needed and
22+
has been removed.
2123

2224
The TYPO3 backend URL is configurable in order to enable optional protection
2325
against application administrator interface infrastructure enumeration
@@ -88,33 +90,6 @@ Note that the :php:`$GLOBALS['TYPO3_CONF_VARS']['SYS']['cookieDomain']` is
8890
necessary, so that backend users can preview website pages or use the admin
8991
panel.
9092

91-
.. _backend-entry-point-legacy-free:
92-
93-
Legacy-free installation
94-
------------------------
95-
96-
The legacy entry point `/typo3/index.php` is no longer needed and deprecated in
97-
favor of handling all backend and frontend requests with :samp:`/index.php`. The
98-
entry point is still in place in case webserver configuration has not been
99-
adapted yet and the maintenance and emergency tool is still available via
100-
:samp:`/typo3/install.php` in order to work in edge cases like broken web server
101-
routing.
102-
103-
In Composer mode, an additional configuration option for the deactivation of
104-
the legacy entry point is provided, which can be defined in the project's
105-
:file:`composer.json`.
106-
107-
.. code-block:: json
108-
:caption: /path/to/project/composer.json (Excerpt)
109-
110-
{
111-
"extra": {
112-
"typo3/cms": {
113-
"install-deprecated-typo3-index-php": false
114-
}
115-
}
116-
}
117-
11893
.. _backend-entry-point-migration:
11994

12095
Migration
@@ -136,7 +111,7 @@ Apache configuration
136111

137112
It is most important to rewrite all `typo3/*` requests to `/index.php`, but also
138113
`RewriteCond %{REQUEST_FILENAME} !-d` should be removed in order for a request
139-
to `/typo3/` to be directly served via `/index.php` instead of the deprecated
114+
to `/typo3/` to be directly served via `/index.php` instead of the removed
140115
entry point `/typo3/index.php`.
141116

142117
Apache configuration before:

0 commit comments

Comments
 (0)