function FieldItemInterface::storageSettingsToConfigData

Same name in other branches
  1. 9 core/lib/Drupal/Core/Field/FieldItemInterface.php \Drupal\Core\Field\FieldItemInterface::storageSettingsToConfigData()
  2. 8.9.x core/lib/Drupal/Core/Field/FieldItemInterface.php \Drupal\Core\Field\FieldItemInterface::storageSettingsToConfigData()
  3. 11.x core/lib/Drupal/Core/Field/FieldItemInterface.php \Drupal\Core\Field\FieldItemInterface::storageSettingsToConfigData()

Returns a settings array that can be stored as a configuration value.

For all use cases where field settings are stored and managed as configuration, this method is used to map from the field type's representation of its settings to a representation compatible with deployable configuration. This includes:

  • Array keys at any depth must not contain a ".".
  • Ideally, array keys at any depth are either numeric or can be enumerated as a "mapping" within the configuration schema. While not strictly required, this simplifies configuration translation UIs, configuration migrations between Drupal versions, and other use cases.
  • To support configuration deployments, references to content entities must use UUIDs rather than local IDs.

An example of a conversion between representations might be an "allowed_values" setting that's structured by the field type as a \Drupal\Core\TypedData\OptionsProviderInterface::getPossibleOptions() result (i.e., values as keys and labels as values). For such a use case, in order to comply with the above, this method could convert that representation to a numerically indexed array whose values are sub-arrays with the schema definable keys of "value" and "label".

Parameters

array $settings: The field's settings in the field type's canonical representation.

Return value

array An array (either the unmodified $settings or a modified representation) that is suitable for storing as a deployable configuration value.

See also

\Drupal\Core\Config\Config::set()

1 method overrides FieldItemInterface::storageSettingsToConfigData()
FieldItemBase::storageSettingsToConfigData in core/lib/Drupal/Core/Field/FieldItemBase.php
Returns a settings array that can be stored as a configuration value.

File

core/lib/Drupal/Core/Field/FieldItemInterface.php, line 329

Class

FieldItemInterface
Interface for entity field items.

Namespace

Drupal\Core\Field

Code

public static function storageSettingsToConfigData(array $settings);

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.