TYPO3\CMS\Core\Configuration\ExtensionConfiguration Class Reference

Public Member Functions
mixed	get (string $extension, string $path='')
	set (string $extension, mixed $value=null)
	setAll (array $configuration, bool $skipWriteIfLocalConfigurationDoesNotExist=false)
	synchronizeExtConfTemplateWithLocalConfigurationOfAllExtensions (bool $skipWriteIfLocalConfigurationDoesNotExist=false)
	synchronizeExtConfTemplateWithLocalConfiguration (string $extensionKey)

Protected Member Functions
	getExtConfTablesWithoutCommentsAsNestedArrayWithoutDots (string $extensionKey)
	getDefaultConfigurationRawString (string $extensionKey)
	hasConfiguration (string $extension)

Detailed Description

API to get() instance specific extension configuration options.

Extension authors are encouraged to use this API - it is currently a simple wrapper to access TYPO3_CONF_VARS['EXTENSIONS'] but could later become something different in case core decides to store extension configuration elsewhere.

Extension authors must not access TYPO3_CONF_VARS['EXTENSIONS'] on their own.

Extension configurations are often 'feature flags' currently defined by ext_conf_template.txt files. The core (more specifically the install tool) takes care default values and overridden values are properly prepared upon loading or updating an extension.

Note only ->get() is official API and other public methods are low level core internal API that is usually only used by extension manager and install tool.

Definition at line 46 of file ExtensionConfiguration.php.

Member Function Documentation

get()

mixed TYPO3\CMS\Core\Configuration\ExtensionConfiguration::get	(	string	$extension,
		string	$path = ''
	)

Get a single configuration value, a sub array or the whole configuration.

Examples: // Simple and typical usage: Get a single config value, or an array if the key is a "TypoScript" // a-like sub-path in ext_conf_template.txt "foo.bar = defaultValue" ->get('myExtension', 'aConfigKey');

// Get all current configuration values, always an array ->get('myExtension');

// Get a nested config value if the path is a "TypoScript" a-like sub-path // in ext_conf_template.txt "topLevelKey.subLevelKey = defaultValue" ->get('myExtension', 'topLevelKey/subLevelKey')

Notes:

• ‪If a configuration or configuration path of an extension is not found, the code tries to synchronize configuration with ext_conf_template.txt first, only if still not found, it will throw exceptions.
• ‪Return values are NOT type safe: A boolean false could be returned as string 0. Cast accordingly.
• ‪This API throws exceptions if the path does not exist or the extension configuration is not available. The install tool takes care any new ext_conf_template.txt values are available TYPO3_CONF_VARS['EXTENSIONS'], a thrown exception indicates a programming error on developer side and should not be caught.
• ‪It is not checked if the extension in question is loaded at all, it's just checked the extension configuration path exists.
• ‪Extensions should typically not get configuration of a different extension.

Parameters

string	$extension	‪Extension name
string	$path	‪Configuration path - e.g. "featureCategory/coolThingIsEnabled"

Returns

‪mixed The value. Can be a sub array or a single value.

Exceptions

ExtensionConfigurationExtensionNotConfiguredException	‪If the extension configuration does not exist
ExtensionConfigurationPathDoesNotExistException	‪If a requested path in the extension configuration does not exist

Definition at line 84 of file ExtensionConfiguration.php.

References $GLOBALS, TYPO3\CMS\Core\Utility\ArrayUtility\getValueByPath(), TYPO3\CMS\Core\Configuration\ExtensionConfiguration\hasConfiguration(), TYPO3\CMS\Core\Utility\ArrayUtility\isValidPath(), and TYPO3\CMS\Core\Configuration\ExtensionConfiguration\synchronizeExtConfTemplateWithLocalConfigurationOfAllExtensions().

Referenced by TYPO3\CMS\Backend\View\AuthenticationStyleInformation\__construct(), and TYPO3\CMS\Backend\Template\PageRendererBackendSetupTrait\getBackendFavicon().

getDefaultConfigurationRawString()

TYPO3\CMS\Core\Configuration\ExtensionConfiguration::getDefaultConfigurationRawString ( string  $extensionKey )

protected

Helper method of ext_conf_template.txt parsing.

Return content of an extensions' ext_conf_template.txt file if the file exists, empty string if file does not exist.

Definition at line 261 of file ExtensionConfiguration.php.

Referenced by TYPO3\CMS\Core\Configuration\ExtensionConfiguration\getExtConfTablesWithoutCommentsAsNestedArrayWithoutDots().

getExtConfTablesWithoutCommentsAsNestedArrayWithoutDots()

TYPO3\CMS\Core\Configuration\ExtensionConfiguration::getExtConfTablesWithoutCommentsAsNestedArrayWithoutDots ( string  $extensionKey )

protected

Helper method of ext_conf_template.txt parsing.

Poor man version of getDefaultConfigurationFromExtConfTemplateAsValuedArray() which ignores comments and returns ext_conf_template as array where nested keys have no dots.

Definition at line 247 of file ExtensionConfiguration.php.

References TYPO3\CMS\Core\Configuration\ExtensionConfiguration\getDefaultConfigurationRawString().

Referenced by TYPO3\CMS\Core\Configuration\ExtensionConfiguration\synchronizeExtConfTemplateWithLocalConfiguration(), and TYPO3\CMS\Core\Configuration\ExtensionConfiguration\synchronizeExtConfTemplateWithLocalConfigurationOfAllExtensions().

hasConfiguration()

TYPO3\CMS\Core\Configuration\ExtensionConfiguration::hasConfiguration ( string  $extension )

protected

Definition at line 273 of file ExtensionConfiguration.php.

References $GLOBALS.

Referenced by TYPO3\CMS\Core\Configuration\ExtensionConfiguration\get().

set()

TYPO3\CMS\Core\Configuration\ExtensionConfiguration::set	(	string	$extension,
		mixed	$value = null
	)

Store a new or overwrite an existing configuration value.

This is typically used by core internal low level tasks like the install tool but may become handy if an extension needs to update extension configuration on the fly for whatever reason.

Examples: // Set a full extension configuration ($value could be a nested array, too) ->set('myExtension', ['aFeature' => 'true', 'aCustomClass' => 'css-foo'])

// Unset a whole extension configuration ->set('myExtension')

Notes:

• ‪Do NOT call this at arbitrary places during runtime (eg. NOT in ext_localconf.php or similar). ->set() is not supposed to be called each request since it writes LocalConfiguration each time. This API is however OK to be called from extension manager hooks.
• ‪Values are not type safe, if the install tool wrote them, boolean true could become string 1 on ->get()
• ‪It is not possible to store 'null' as value, giving $value=null or no value at all will unset the path
• ‪Setting a value and calling ->get() afterwards will still return the new value.
• ‪Warning on system/additional.php: If this file overwrites settings, it spoils the ->set() call and values may not end up as expected.

Parameters

string	$extension	‪Extension name
mixed | null	$value	‪The value. If null, unset the path

Definition at line 150 of file ExtensionConfiguration.php.

References $GLOBALS.

setAll()

TYPO3\CMS\Core\Configuration\ExtensionConfiguration::setAll	(	array	$configuration,
		bool	$skipWriteIfLocalConfigurationDoesNotExist = false
	)

Set new configuration of all extensions and reload TYPO3_CONF_VARS. This is a "do all" variant of set() for all extensions that prevents writing and loading system/settings.php many times.

Parameters

array

$configuration

‪Configuration of all extensions

Definition at line 177 of file ExtensionConfiguration.php.

References $GLOBALS.

Referenced by TYPO3\CMS\Core\Configuration\ExtensionConfiguration\synchronizeExtConfTemplateWithLocalConfigurationOfAllExtensions().

synchronizeExtConfTemplateWithLocalConfiguration()

TYPO3\CMS\Core\Configuration\ExtensionConfiguration::synchronizeExtConfTemplateWithLocalConfiguration

(

string

$extensionKey

)

Read values from ext_conf_template, verify if they are in LocalConfiguration.php already and if not, add them.

Used public by extension manager when updating extension

Definition at line 226 of file ExtensionConfiguration.php.

References $GLOBALS, and TYPO3\CMS\Core\Configuration\ExtensionConfiguration\getExtConfTablesWithoutCommentsAsNestedArrayWithoutDots().

synchronizeExtConfTemplateWithLocalConfigurationOfAllExtensions()

TYPO3\CMS\Core\Configuration\ExtensionConfiguration::synchronizeExtConfTemplateWithLocalConfigurationOfAllExtensions

(

bool

$skipWriteIfLocalConfigurationDoesNotExist = false

)

If there are new config settings in ext_conf_template of an extension, they are found here and synchronized to LocalConfiguration['EXTENSIONS'].

Used when entering the install tool, during installation and if calling ->get() with an extension or path that is not yet found in LocalConfiguration

Definition at line 195 of file ExtensionConfiguration.php.

References $GLOBALS, TYPO3\CMS\Core\Configuration\ExtensionConfiguration\getExtConfTablesWithoutCommentsAsNestedArrayWithoutDots(), and TYPO3\CMS\Core\Configuration\ExtensionConfiguration\setAll().

Referenced by TYPO3\CMS\Core\Configuration\ExtensionConfiguration\get().