Zum Inhalt springen

Upgrade from TYPO3 6.2 to 7

Using our sample project as an example, we will show you how to upgrade from TYPO3 6.2 to 7.

Upgrading from TYPO3 6.2 to 7 is usually much easier than upgrading from TYPO3 4.5 to 6.2, for example.

Using our sample project as an example, we will show you the upgrade process. You can also see here what should be considered when upgrading.

Quick guide

Please note that TYPO3 7 requires at least PHP 5.5. You should therefore switch to at least this version in the domain administration.

  1. Create a copy of the TYPO3 project
  2. Update extensions as far as possible (to the latest version compatible with TYPO3 6.2)
  3. Update the reference index
  4. In the install tool ' Important Actions ' "Compare current database with specification"
  5. Unpack the typo3_src-7.6.x.tar.gz archive
    :tar xzf typo3_src-7.6.x.tar.gz
  6. Let the symlink typo3_src point to typo3_src.7.6.x in the project directory
  7. Call the install tool again: name-der-domain.de/typo3/install
  8. In the event of an error message (see below), change the PHP edition to "EXTENDED" in the customer menu in the domain administration
  9. Go through all points of the upgrade wizard
    • Only install the "compatibility6" extension if extensions that are not yet compatible with TYPO3 7 are absolutely necessary. If possible, do without this extension for performance reasons.
    • Install the "mediace" extension if you use the "Media" content element. If not, you can do without it.
  10. Perform another "Database Compare" in the "Important Actions" area and confirm the changes to the database
  11. Click on the "Clear all cache" button in the "Important Actions" area
  12. Activate the PHP error output. In the "Configuration Presets" either switch to "Debug" mode or to "Custom" and set the parameter displayErrors to 1.
  13. Switch to the TYPO3 backend
  14. Update the extension list in the Extension Manager and update all extensions to the latest version
  15. Update the translations of the required languages in the Language module
  16. Test the backend and frontend carefully

Please also note that some extensions may require adjustments to the TypoScript or templates. Please refer to the documentation of the respective extensions.

Error message when using PHP as FASTCGI (for point 8)

If PHP is used as FASTCGI (recommended for performance reasons!), the following error message will appear the first time the install tool is called after the symlink has been changed:

Calculated absolute path to tslib directory does not exist. 

Something in the main file, folder and link structure is wrong and must be fixed! A typical document root contains a couple of symbolic links:
* A symlink "typo3_src" pointing to the TYPO3 CMS core.
* A symlink "typo" - the backend entry point - pointing to "typo3_src/typo3"
* A symlink "index.php" - the frontend entry point - points to "typo3_src/index.php"

Solution: For the upgrade, set the PHP edition used for the affected domain to "EXTENDED" in the domain administration of the customer menu. After a successful upgrade, you can switch back to "FASTCGI".

No access to the backend after the upgrade?

If you can no longer access the backend after the upgrade by calling domain.de/typo3/, but only via domain.de/typo3/index.php, add the following line to the .htaccess file in the project directory.

RewriteCond %{REQUEST_FILENAME} !-d

500 Error when calling up the front end

This error is usually caused by /index.php. By replacing /index.php with /typo3_src-7.x/index.php this can usually be rectified.

This page contains automatically translated content.

Updated: 17.07.2024