Skip to content

Commit

Permalink
[Backport 13.4] Upgrade to TYPO3 13 (#5248)
Browse files Browse the repository at this point in the history
* Upgrade to TYPO3 13 

Also the example version numbers should show the newest version 13.

* add PHP version requirement

* add hint about config platform PHP

* add really necessary system extensions

* Update UpgradeCore.rst

---------

Co-authored-by: Franz Holzinger <[email protected]>
Co-authored-by: Lina Wolf <[email protected]>
  • Loading branch information
3 people authored Jan 24, 2025
1 parent 2d0134e commit b5f9b41
Showing 1 changed file with 29 additions and 16 deletions.
45 changes: 29 additions & 16 deletions Documentation/Administration/Upgrade/Major/UpgradeCore.rst
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

0 comments on commit b5f9b41

Please sign in to comment.