Translations
Info
All page names need to be in English.
en da  de  fr  it  ja  km  nl  ru  zh

Upgrade

From TYPO3Wiki
Jump to: navigation, search
This page belongs to the Core Team (category Core Team)

<< Back to Getting started page

[edit]

This is a step by step guide on how to upgrade an installation of TYPO3 to a newer version.

notice - Note

If a step is not understandable, you can note that here!

notice - Note

This wiki page is an amendment to the section "Upgrade" in the Installation and Upgrade Guide. The guide contains the general upgrade information, which you should follow. This wiki page holds additions to this information for the upgrade to a specific version.

General information

Read the notes

You should not only go through the upgrade notes, which this page has for the version, to which you are updating, but also the notes for any intermediate versions, as these might also contain instructions you should follow.

You should also read the Release Notes of the main versions you go through when updating (e.g. 6.2.0 and 7.6.0). These documents contain a section called "Upgrading", which you should follow. See list of all Release Notes.

Upgrading to 7.6 Long Term Support

Situation: You want to upgrade from version 6.2 to 7 LTS.

You need PHP 5.5 at least!

You must use TYPO3 6.2 or newer before you upgrade to TYPO3 7 LTS! Make sure that before you upgrade to TYPO3 7.6, you have run all Upgrade Wizards in TYPO3 6.2. Upgrade wizards from before 6.2 LTS are not available anymore in 7, which makes it impossible to update from a version older than TYPO3 6.2.

After upgrading

An overview of all major changes in TYPO3 CMS is available here: https://docs.typo3.org/typo3cms/extensions/core/7.6/Index.html.

  • The possibility of having a file called typo3conf/extTables.php has been deprecated. Instead of having code in this file, use extensions!
  • If you are using content elements with CType media or multimedia, the extension mediace will be added to your installation to handle these CTypes. Alternatively, in TYPO3 7, you can install the system extension fluid_styled_content, which is an experimental replacement for css_styled_content. For media content elements you can then use the "Text & Media" content element type of this extension. Note that fluid_styled_content will remove a number of CTypes, among them text ("Text") and textpic ("Text & Images"), from the New Content Element wizard. When fluid_styled_content is installed and css_styled_content is not, there will be an upgrade wizard to migrate content elements, which use CTypes originally provided by css_styled_content. Note that you will most likely have to adjust your CSS styles in order to again get the Frontend output you want! For videos on YouTube, Vimeo and so on, another option is the "online media" feature of the Core; see 61799: TYPO3 Core - Improve the handling of media files [Closed; assigned to Frans Saris] and its documentation.
  • There is an Upgrade Wizard, which changes the startup modules of your Backend users. After you have run through the Upgrade Wizards, you might want to change the startup module for the Backend users again.

Upgrading to 8.7 Long Term Support

Situation: You want to upgrade from version 7.6 LTS to 8.7 LTS

You need PHP 7 at least!

You must use TYPO3 7.6 or newer before you upgrade to TYPO3 8 LTS! Make sure that before you upgrade to TYPO3 8.7, you have run all Upgrade Wizards in TYPO3 7.6. Upgrade wizards from before 7.6 LTS are not available anymore in 8, which makes it impossible to update from a version older than TYPO3 7.6.

Note that this upgrade is faster than the upgrade to TYPO3 7.6!

After upgrading

An overview of all major changes in TYPO3 CMS is available in the new Upgrade Analysis section in the Install Tool.

Database credentials in AdditionalConfiguration.php

Like all configuration in AdditionalConfiguration.php, also database configuration in that file has to be upgraded manually - in this case from $GLOBALS['TYPO3_CONF_VARS']['DB'] to $GLOBALS['TYPO3_CONF_VARS']['DB']['Connections']['Default']:

Old New
  • $GLOBALS['TYPO3_CONF_VARS']['DB']['database']
  • $GLOBALS['TYPO3_CONF_VARS']['DB']['host']
  • $GLOBALS['TYPO3_CONF_VARS']['DB']['username']
  • $GLOBALS['TYPO3_CONF_VARS']['DB']['password']
  • $GLOBALS['TYPO3_CONF_VARS']['DB']['port']
  • $GLOBALS['TYPO3_CONF_VARS']['DB']['Connections']['Default']['charset']
  • $GLOBALS['TYPO3_CONF_VARS']['DB']['Connections']['Default']['driver']
  • $GLOBALS['TYPO3_CONF_VARS']['DB']['Connections']['Default']['dbname']
  • $GLOBALS['TYPO3_CONF_VARS']['DB']['Connections']['Default']['host']
  • $GLOBALS['TYPO3_CONF_VARS']['DB']['Connections']['Default']['user']
  • $GLOBALS['TYPO3_CONF_VARS']['DB']['Connections']['Default']['password']
  • $GLOBALS['TYPO3_CONF_VARS']['DB']['Connections']['Default']['port']

Notes

  • The system extension css_styled_content has been marked as deprecated and will be removed in TYPO3 CMS 9. Use fluid_styled_content instead!
    If you used your TypoScript template to modify the output of tt_content or lib.stdheader, you will have to adjust these changes. E.g. if you used tt_content.stdWrap.innerWrap2 to modify the link "to top", you will now have to define a path with lib.contentElement.partialRootPaths and you will have to modify the file Footer/All.html, which contains the according partial in fluid_styled_content. A tutorial video about what the structure of fluid_styled_content looks like and about how to modify the different templates/partials/layouts is available at https://jweiland.net/video-anleitungen/typo3/typo3-projekte-verwalten/fluid-styled-content-templates-anpassen.html.
  • The old Rich Text Editor rtehtmlarea has been removed from the TYPO3 Core. Its replacement is rte_ckeditor. A tutorial on how to configure rte_ckeditor is available here. If you for now still want to continue using the old editor, you can use the Upgrade Wizard in the Install Tool to import it from TER.
  • The path for the CLI binary and all CLI commands have changed.
    • Scheduler:
      • Old: typo3/cli_dispatch.phpsh scheduler
      • New: typo3/sysext/core/bin/typo3 scheduler:run
    • Reference index:
      • Old: typo3/cli_dispatch.phpsh lowlevel_refindex -e
      • New: typo3/sysext/core/bin/typo3 referenceindex:update
  • ...

Upgrading to 9.5 Long Term Support

Situation: You want to upgrade from version 8.7 LTS to 9.5 LTS

You need PHP 7.2 at least!

You must use TYPO3 8.7 or newer before you upgrade to TYPO3 9 LTS! Make sure that before you upgrade to TYPO3 9.5, you have run all Upgrade Wizards in TYPO3 8.7. Upgrade wizards from before 8.7 LTS are not available anymore in 9, which makes it impossible to update from a version older than TYPO3 8.7.

After upgrading

An overview of all major changes in TYPO3 CMS is available in the new Upgrade Analysis section in the Install Tool.

Notes

  • TYPO3 9 offers a way to create readable URLs out of the box so that extensions like RealURL become unnecessary. A configuration for the website has to be created in the new Sites backend module for this to work. See https://www.youtube.com/watch?v=dUz4B08XFes for an introduction.
    Internally, the column pages.slug is used and an Upgrade Wizard is available, which can transfer page paths e.g. from tx_realurl_pathcache/tx_realurl_pathdata and from the pages.alias field to said column. This will however not work for deleted pages. It should be checked, if pages paths stayed the same before RealURL data gets deleted.
  • In order to benefit from the new frontend editing of extension frontend_editing, you might want to adjust the FE editing part of your TypoScript template and possibly your HTML template.
  • Amongst others, cObject FILE got deprecated and will be removed in TYPO3 10. This e.g. influences cObject TEMPLATE which now gives a deprecation message, if used with cObject FILE.
  • The Admin Tool also can be used to toggle usage of pages_language_overlay on or off. For new installations, it defaults to off.
  • The Extension Scanner in the Admin Tool can be used to check extensions for usages of deprecated functions. It directly links to the associated documentation with migration hints.