Maintenance (Admin Tools)

Only available if typo3/cms-install is installed.

The backend module Admin Tools > Maintenance offers tools to system maintainers that are necessary during development or updates.

Some of the tools available here include:

Flush TYPO3 and PHP Cache

By clicking the button Flush cache you can flush all caches. This is necessary during development if you changed files like Fluid templates, TypoScript files, or PHP files.

It is also necessary to flush caches after installing or updating extensions.

You can achieve the same effect by calling

ddev typo3 cache: flush

Note

Flushing the cache via the "Clear cache" buttons in the Top Bar does not have the same effect. It does not flush PHP related caches.

Analyze Database Structure

Before running a database compare, try flushing the cache. This flushes cached TCA definitions that might inadvertently determine the database structure.

Despite its name, this tool not only analyzes the database structure but also offers to fix it for you.

Database changes can be necessary when TCA files have changed or extensions installed / updated.

Add tables and columns using the database analyzer

When the database analyser suggests adding columns or tables you can safely do so.

Change or remove columns and tables in the database analyzer

Before you remove tables or columns, make a database backup.

The database analyzer gives you the possibility to remove old and redundant tables and columns from the database.

It executes queries to remove these tables and columns so that your database corresponds to the structure required in the new TYPO3 version.

Note

TYPO3 does not immediately delete tables and fields. Instead, it adds a zzz_deleted_* prefix to the table names.

This lets you verify whether they’re truly obsolete or just mistakenly marked for deletion. Once confirmed, you can permanently remove them via the wizard.

When you then click "Compare current database with specification" again and you see the message "Database schema is up to date. Good job!", then all database updates have been applied.

Remove temporary assets

After an upgrade to a new major version, it might be necessary to delete temporary files which TYPO3 saves in the typo3temp/ folder.

In the Admin Tools > Maintenance module, click on the Remove Temporary Assets > Scan temporary files button and select the appropriate folders.

Rebuild PHP autoload information

This tool in module Admin Tools > Maintenance is only available in classic mode installations. If PHP classes are not found even after flushing the cache, rebuilding the autoload information might help.

In Composer mode installations you can use the following Composer command to achieve the same thing:

composer dump-autoload

Clear persistent database tables

You can use this tool to clear persistent database tables like sys_log and sys_history manually.

If you need to clear these tables on a regular basis, set up a task in the module System > Scheduler.

Create administrative user

This tool can be used to create a new administrative backend user with or without maintainer privileges.

You can also create new backend users using the console:

vendor/bin/typo3 backend:user:create

and in the module System > Backend Users. Using this module, admins can create new admins but not system maintainers.

Reset backend user preferences

You might consider clearing the Backend user preferences. This can avoid problems if something in the upgrade requires this. Open Admin Tools > Maintanance, scroll to "Reset user preferences" and click "Reset backend user preferences".

Manage language packs

In the module Admin Tools > Maintenance, open tool "Manage language packs". You can add additional languages to be downloaded or update the language packs for languages already in use.