FIELD_CONFIG_VERSION = 'configVersion'
processConfiguration(array $values) : array
Normalizes and validates the given values.
When this version of the configuration can be upgraded (which is detected by the Upgradable interface on the Configuration definition) then it will do so and re-run this method with the upgraded values. The 'configVersion' field will tell which definition should be used; when none is provided then a version 2 configuration is assumed.
because this method is called recursively, the provided shape varies and is the output of the ConfigurationDefinition matching the prior configVersion is used.
the recursiveness of this method means that the output of this method has the shape of the current ConfigurationDefinition's output.
upgradeConfiguration(\phpDocumentor\Configuration\Definition\Upgradable $definition, array $configuration) : array
because this method is called as part of the recursive method processConfiguration, the provided shape varies and is the output of the normalisation process of provided ConfigurationDefinition.
this method's output will match the shape of the output of the provided ConfigurationDefinition.