The 5 points TYPO3 generic problem resolution Checklist

Sometimes you find a problem in TYPO3 CMS that you don't find quickly a solution, or you don't know exactly was is the source and where to looking for.

This is the quickly 5 points that every TYPO3 Developer do to solve the problem:

  1. Clear the cache

    • All, page, configuration caches

    • Check if localconf/temp_CACHED_* files are deleted in TYPO3 4.5 versions

    • Rename typo3temp/Cache folder in typo3temp/__deleteme__Cache in newer TYPO3 versions  and after tested it works just delete it

  2. Inside install tools compare DB and update

    • Deselect rename to zzz_* fields and tables if you are not really really sure of it (at the end of the compare)

    • Deselect drop zzz_* fields and tables if you are not really really sure of it

  3. Look for error in your log files:

    • Open the log in plesk or your panel or in your terminal and look for some php error

    • Enable deprecation log and look inside, usually are only warning, but sometimes it can give you an idea

    • Enable log in install tool, devlog, Dlog and sql log, of course only for your IP, you can do all in your localconf:
      $TYPO3_CONF_VARS['SYS']['devIPmask'] = ',::1,PUT.HERE.YOUR.IP';
      $TYPO3_CONF_VARS['SYS']['enable_DLOG'] = '1';
      $TYPO3_CONF_VARS['SYS']['systemLog'] = 'file,/var/www/vhosts/your_website/httpdocs/typo3conf/log.txt';
      $TYPO3_CONF_VARS['SYS']['enableDeprecationLog'] = 'file';
      $TYPO3_CONF_VARS['SYS']['enable_errorDLOG'] = '1';
      $TYPO3_CONF_VARS['SYS']['enable_exceptionDLOG'] = '1';
      $TYPO3_CONF_VARS['SYS']['sqlDebug'] = '1';

  4. Look for TypoScript errors

    • Open template -> maintemplate in home -> Template Analyzer for errors

    • Repeat for all templates

  5. Open phpinfo (in install tool) Look if memory_limit is enough it should be > 64M, max_execution_time > 60 seconds.

    • Some projects needs more than 128M and 240 sec.