Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Backport 13.4] Upgrade to TYPO3 13 #5248

Merged
merged 5 commits into from
Jan 24, 2025
Merged

[Backport 13.4] Upgrade to TYPO3 13 #5248

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
3ec2860
Upgrade to TYPO3 13
franzholz Jan 19, 2025
8dafb4d
add PHP version requirement
franzholz Jan 19, 2025
ed8567c
add hint about config platform PHP
franzholz Jan 19, 2025
8f7c52d
add really necessary system extensions
franzholz Jan 19, 2025
4826fa2
Update UpgradeCore.rst
linawolf Jan 20, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 29 additions & 16 deletions Documentation/Administration/Upgrade/Major/UpgradeCore.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,17 @@ Upgrading to a major release using Composer
===========================================

This example details how to upgrade from one LTS release to another. In this
example, the installation is running TYPO3 version 11.5.34 and the new LTS
release is version 12.4.10.
example, the installation is running TYPO3 version 12.4.25 and the new LTS
release is version 13.4.3.

Check the required PHP version
------------------------------

On https://get.typo3.org/ you can find the required PHP versions to run a
certain TYPO3 version. For example TYPO3 13 requires at least PHP 8.2.

How to switch your PHP version depends on the hosting you are using. Please
check with your hosting provider.

Check which TYPO3 packages are currently installed
--------------------------------------------------
Expand All @@ -34,7 +43,7 @@ To upgrade a Composer package, run :bash:`composer require` with the package nam
version number.

For example, to upgrade `typo3/cms-backend` run
:bash:`composer require typo3/cms-backend:^12.4`.
:bash:`composer require typo3/cms-backend:^13.4`.

When upgrading to a new major release, each of TYPO3's packages will need to be
upgraded.
Expand All @@ -55,28 +64,32 @@ be used to help generate the Composer upgrade command.
composer remove "typo3/cms-t3editor"

Assuming that the packages below are installed locally, the following example
would upgrade each of them to version 12.4.
would upgrade each of them to version 13.4.

.. code-block:: bash

composer require --update-with-all-dependencies "typo3/cms-adminpanel:^12.4" \
"typo3/cms-backend:^12.4" "typo3/cms-belog:^12.4" "typo3/cms-beuser:^12.4" \
"typo3/cms-core:^12.4" "typo3/cms-dashboard:^12.4" "typo3/cms-felogin:^12.4" \
"typo3/cms-filelist:^12.4" "typo3/cms-filemetadata:^12.4" "typo3/cms-fluid:^12.4" \
"typo3/cms-form:^12.4" "typo3/cms-frontend:^12.4" "typo3/cms-info:^12.4" \
"typo3/cms-install:^12.4" "typo3/cms-linkvalidator:^12.4" "typo3/cms-lowlevel:^12.4" \
"typo3/cms-recycler:^12.4" "typo3/cms-rte-ckeditor:^12.4" "typo3/cms-setup:^12.4" \
"typo3/cms-t3editor:^12.4" "typo3/cms-tstemplate:^12.4" "typo3/cms-viewpage:^12.4"
composer require --update-with-all-dependencies "typo3/cms-adminpanel:^13.4" \
"typo3/cms-backend:^13.4" "typo3/cms-belog:^13.4" "typo3/cms-beuser:^13.4" \
"typo3/cms-core:^13.4" "typo3/cms-dashboard:^13.4" "typo3/cms-extbase:^13.4" \
"typo3/cms-extensionmanager:^13.4" "typo3/cms-felogin:^13.4" "typo3/cms-fluid-styled-content:^13.4" \
"typo3/cms-filelist:^13.4" "typo3/cms-filemetadata:^13.4" "typo3/cms-fluid:^13.4" \
"typo3/cms-form:^13.4" "typo3/cms-frontend:^13.4" "typo3/cms-impexp:^13.4" \
"typo3/cms-info:^13.4" "typo3/cms-install:^13.4" "typo3/cms-linkvalidator:^13.4" \
"typo3/cms-lowlevel:^13.4" "typo3/cms-reactions:^13.4" "typo3/cms-recycler:^13.4" \
"typo3/cms-rte-ckeditor:^13.4" "typo3/cms-seo:^13.4" "typo3/cms-setup:^13.4" \
"typo3/cms-sys-note:^13.4" "typo3/cms-t3editor:^13.4" "typo3/cms-tstemplate:^13.4" \
"typo3/cms-viewpage:^13.4" "typo3/cms-webhooks:^13.4"


A typical TYPO3 installation is likely to have multiple third-party extensions
installed and running the above command can create dependency errors.

For example, when upgrading from TYPO3 v11 LTS to v12 LTS an error can occur
stating that `"helhum/typo3-console": "^7.1"` is only compatible with v11 LTS,
with the new version `^8.1` supporting TYPO3 v12 LTS.
For example, when upgrading from TYPO3 v12 LTS to v13 LTS an error can occur
stating that `"helhum/typo3-console": "^8.1"` is only compatible with v12 LTS,
with the new version `^9.1` supporting TYPO3 v13 LTS.

For each of these dependency errors, add the version requirement
`"helhum/typo3-console:^8.1"` to the end of your :bash:`composer require` string
`"helhum/typo3-console:^9.1"` to the end of your :bash:`composer require` string
and retry the command.

Monitoring changes to TYPO3's Core
Expand Down