SiteConfiguration
class \
- Implements
- SingletonInterface
Responsibility: Handles the format of the configuration (currently yaml), and the location of the file system folder
Reads all available site configuration options, and puts them into Site objects.
Internal
Table of Contents
Interfaces
- SingletonInterface
- "empty" interface for singletons (marker interface pattern)
Properties
- $cache : PhpFrontend
- $cacheIdentifier : string
- Identifier to store all configuration data in the core cache.
- $configFileName : string
- Config yaml file name.
- $configPath : string
- $contentSecurityFileName : string
- YAML file name with all settings related to Content-Security-Policies.
- $eventDispatcher : EventDispatcherInterface
- $firstLevelCache : array|null
- Cache stores all configuration as Site objects, as long as they haven't been changed.
- $settingsFileName : string
- YAML file name with all settings.
Methods
- __construct() : mixed
- createNewBasicSite() : void
- Creates a site configuration with one language "English" which is the de-facto default language for TYPO3 in general.
- delete() : void
- Removes the config.yaml file of a site configuration.
- getAllExistingSites() : Site[]
- Return all site objects which have been found in the filesystem.
- getAllSiteConfigurationPaths() : array
- Returns an array of paths in which a site configuration is found.
- load() : array
- Load plain configuration without additional settings.
- rename() : void
- Renames a site identifier (and moves the folder)
- resolveAllExistingSites() : Site[]
- Resolve all site objects which have been found in the filesystem.
- resolveAllExistingSitesRaw() : Site[]
- Resolve all site objects which have been found in the filesystem containing settings only from the `config.yaml` file ignoring values from the `settings.yaml` and `csp.yaml` file.
- warmupCaches() : void
- write() : void
- Add or update a site configuration
- writeSettings() : void
- findModified() : array
- findRemoved() : array
- getAllSiteConfigurationFromFiles() : array
- Read the site configuration from config files.
- getContentSecurityPolicies() : array
- getSiteSettings() : SiteSettings
- Fetch the settings for a specific site and return the parsed Site Settings object.
- protectPlaceholders() : array<string, mixed>
- Detects placeholders that have been introduced and handles* them.
- sortConfiguration() : array
Properties
$cache
protected
PhpFrontend
$cache
$cacheIdentifier
Identifier to store all configuration data in the core cache.
protected
string
$cacheIdentifier
= 'sites-configuration'
Internal
$configFileName
Config yaml file name.
protected
string
$configFileName
= 'config.yaml'
Internal
$configPath
protected
string
$configPath
$contentSecurityFileName
YAML file name with all settings related to Content-Security-Policies.
protected
string
$contentSecurityFileName
= 'csp.yaml'
Internal
$eventDispatcher
protected
EventDispatcherInterface
$eventDispatcher
$firstLevelCache
Cache stores all configuration as Site objects, as long as they haven't been changed.
protected
array|null
$firstLevelCache
This drastically improves performance as SiteFinder utilizes SiteConfiguration heavily
$settingsFileName
YAML file name with all settings.
protected
string
$settingsFileName
= 'settings.yaml'
Internal
Methods
__construct()
public
__construct(string $configPath, EventDispatcherInterface $eventDispatcher[, PhpFrontend|null $coreCache = null ]) : mixed
Parameters
- $configPath : string
- $eventDispatcher : EventDispatcherInterface
- $coreCache : PhpFrontend|null = null
createNewBasicSite()
Creates a site configuration with one language "English" which is the de-facto default language for TYPO3 in general.
public
createNewBasicSite(string $identifier, int $rootPageId, string $base) : void
Parameters
- $identifier : string
- $rootPageId : int
- $base : string
Tags
delete()
Removes the config.yaml file of a site configuration.
public
delete(string $siteIdentifier) : void
Also clears the cache.
Parameters
- $siteIdentifier : string
Tags
getAllExistingSites()
Return all site objects which have been found in the filesystem.
public
getAllExistingSites([bool $useCache = true ]) : Site[]
Parameters
- $useCache : bool = true
Return values
Site[]getAllSiteConfigurationPaths()
Returns an array of paths in which a site configuration is found.
public
getAllSiteConfigurationPaths() : array
Internal
Return values
arrayload()
Load plain configuration without additional settings.
public
load(string $siteIdentifier) : array
This method should only be used in case the original configuration as it exists in the file should be loaded, for example for writing / editing configuration.
All read related actions should be performed on the site entity.
Parameters
- $siteIdentifier : string
Return values
arrayrename()
Renames a site identifier (and moves the folder)
public
rename(string $currentIdentifier, string $newIdentifier) : void
Parameters
- $currentIdentifier : string
- $newIdentifier : string
Tags
resolveAllExistingSites()
Resolve all site objects which have been found in the filesystem.
public
resolveAllExistingSites([bool $useCache = true ]) : Site[]
Parameters
- $useCache : bool = true
Return values
Site[]resolveAllExistingSitesRaw()
Resolve all site objects which have been found in the filesystem containing settings only from the `config.yaml` file ignoring values from the `settings.yaml` and `csp.yaml` file.
public
resolveAllExistingSitesRaw() : Site[]
Internal
Not part of public API. Used as intermediate solution until settings are handled by a dedicated GUI.
Return values
Site[]warmupCaches()
public
warmupCaches(CacheWarmupEvent $event) : void
Parameters
- $event : CacheWarmupEvent
write()
Add or update a site configuration
public
write(string $siteIdentifier, array $configuration[, bool $protectPlaceholders = false ]) : void
Parameters
- $siteIdentifier : string
- $configuration : array
- $protectPlaceholders : bool = false
-
whether to disallow introducing new placeholders
Tags
writeSettings()
public
writeSettings(string $siteIdentifier, array $settings) : void
Parameters
- $siteIdentifier : string
- $settings : array
findModified()
protected
static findModified(array $currentConfiguration, array $newConfiguration) : array
Parameters
- $currentConfiguration : array
- $newConfiguration : array
Return values
arrayfindRemoved()
protected
static findRemoved(array $currentConfiguration, array $newConfiguration) : array
Parameters
- $currentConfiguration : array
- $newConfiguration : array
Return values
arraygetAllSiteConfigurationFromFiles()
Read the site configuration from config files.
protected
getAllSiteConfigurationFromFiles([bool $useCache = true ]) : array
Parameters
- $useCache : bool = true
Tags
Return values
arraygetContentSecurityPolicies()
protected
getContentSecurityPolicies(string $siteIdentifier) : array
Parameters
- $siteIdentifier : string
Return values
arraygetSiteSettings()
Fetch the settings for a specific site and return the parsed Site Settings object.
protected
getSiteSettings(string $siteIdentifier, array $siteConfiguration) : SiteSettings
Parameters
- $siteIdentifier : string
- $siteConfiguration : array
Tags
Return values
SiteSettingsprotectPlaceholders()
Detects placeholders that have been introduced and handles* them.
protected
protectPlaceholders(array<string, mixed> $existingConfiguration, array<string, mixed> $modifiedConfiguration) : array<string, mixed>
(*) currently throws an exception, but could be purged or escaped as well
Parameters
- $existingConfiguration : array<string, mixed>
- $modifiedConfiguration : array<string, mixed>
Tags
Return values
array<string, mixed> —sanitized configuration (currently not used, exception thrown before)
sortConfiguration()
protected
sortConfiguration(array $newConfiguration) : array
Parameters
- $newConfiguration : array