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.