Attention

TYPO3 v8 has reached its end-of-life March 31st, 2020 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.

There is no further ELTS support. It is recommended that you upgrade your project and use a supported version of TYPO3.

The LocalConfiguration.php file¶

The global configuration is stored in file typo3conf/LocalConfiguration.php.

Important

Since configuration settings can be manipulated from within the TYPO3 CMS backend, the typo3conf/LocalConfiguration.php must be writable by the web server user.

The local configuration file is basically a long array which is simply returned when the file is included. It represents the global TYPO3 CMS configuration. This configuration can be modified/extended/overridden by extensions, by setting configuration options inside an extension's ext_localconf.php file. See Core APIs for more details about extension structure.

Here is the local configuration file after the basic installation:

<?php
return [
        'BE' => [
                'debug' => true,
                'explicitADmode' => 'explicitAllow',
                'installToolPassword' => '$P$Cbp90UttdtIKELNrDGjy4tDxh3uu9D/',
                'loginSecurityLevel' => 'rsa',
        ],
        'DB' => [
                'Connections' => [
                        'Default' => [
                                'charset' => 'utf8',
                                'dbname' => 'empty_typo3',
                                'driver' => 'mysqli',
                                'host' => '127.0.0.1',
                                'password' => 'foo',
                                'port' => 3306,
                                'user' => 'bar',
                        ],
                ],
        ],
        'EXT' => [
                'extConf' => [
                        'css_styled_content' => 'a:1:{s:32:"loadContentElementWizardTsConfig";s:1:"1";}',
                        'doc_tut_templating' => 'a:0:{}',
                        'rsaauth' => 'a:1:{s:18:"temporaryDirectory";s:0:"";}',
                        'saltedpasswords' => 'a:2:{s:3:"BE.";a:4:{s:21:"saltedPWHashingMethod";s:41:"TYPO3\\CMS\\Saltedpasswords\\Salt\\PhpassSalt";s:11:"forceSalted";i:0;s:15:"onlyAuthService";i:0;s:12:"updatePasswd";i:1;}s:3:"FE.";a:5:{s:7:"enabled";i:1;s:21:"saltedPWHashingMethod";s:41:"TYPO3\\CMS\\Saltedpasswords\\Salt\\PhpassSalt";s:11:"forceSalted";i:0;s:15:"onlyAuthService";i:0;s:12:"updatePasswd";i:1;}}',
                        't3editor' => 'a:0:{}',
                ],
        ],
        'FE' => [
                'debug' => true,
                'loginSecurityLevel' => 'rsa',
        ],
        'GFX' => [
                'jpg_quality' => '80',
        ],
        'MAIL' => [
                'transport_sendmail_command' => '/usr/sbin/sendmail -t -i ',
        ],
        'SYS' => [
                'caching' => [
                        'cacheConfigurations' => [
                                'extbase_object' => [
                                        'backend' => 'TYPO3\\CMS\\Core\\Cache\\Backend\\Typo3DatabaseBackend',
                                        'frontend' => 'TYPO3\\CMS\\Core\\Cache\\Frontend\\VariableFrontend',
                                        'groups' => [
                                                'system',
                                        ],
                                        'options' => [
                                                'defaultLifetime' => 0,
                                        ],
                                ],
                        ],
                ],
                'devIPmask' => '*',
                'displayErrors' => 1,
                'enableDeprecationLog' => 'file',
                'encryptionKey' => '0396e1b6b53bf48b0bfed9e97a62744158452dfb9b9909fe32d4b7a709816c9b4e94dcd69c011f989d322cb22309f2f2',
                'exceptionalErrors' => 28674,
                'isInitialDatabaseImportDone' => true,
                'isInitialInstallationInProgress' => false,
                'sitename' => 'New TYPO3 site',
                'sqlDebug' => 1,
                'systemLogLevel' => 0,
        ],
];

As you can see, the array is structured on two main levels. The first level corresponds roughly to a category, the second one being properties, which may themselves be arrays.

The configuration categories are:

BE: Options related to the TYPO3 CMS backend
DB: Database connection configuration
EXT: Extension configuration options. The settings of each extension is stored as a serialized array.
FE: Frontend-related options.
GFX: Options related to image manipulation.
MAIL: Options related to the sending of emails (transport, server, etc.).
SYS: General options which may affect both the frontend and the backend.

Details on the various configuration-options can be found in the install-tool as well as the TYPO3-source at typo3/sysext/core/Configuration/DefaultConfigurationDescription.php. The documentation shown in the install-tool is automatically extracted from those values of DefaultConfigurationDescription.php.