public function FieldStorageConfigStorage::loadByProperties in Zircon Profile 8
Same name and namespace in other branches
- 8.0 core/modules/field/src/FieldStorageConfigStorage.php \Drupal\field\FieldStorageConfigStorage::loadByProperties()
Load entities by their property values.
Parameters
array $values: An associative array where the keys are the property names and the values are the values those properties must have.
Return value
\Drupal\Core\Entity\EntityInterface[] An array of entity objects indexed by their ids.
Overrides EntityStorageBase::loadByProperties
File
- core/
modules/ field/ src/ FieldStorageConfigStorage.php, line 102 - Contains \Drupal\field\FieldStorageConfigStorage.
Class
- FieldStorageConfigStorage
- Controller class for "field storage" configuration entities.
Namespace
Drupal\fieldCode
public function loadByProperties(array $conditions = array()) {
// Include deleted fields if specified in the $conditions parameters.
$include_deleted = isset($conditions['include_deleted']) ? $conditions['include_deleted'] : FALSE;
unset($conditions['include_deleted']);
/** @var \Drupal\field\FieldStorageConfigInterface[] $storages */
$storages = array();
// Get field storages living in configuration. If we are explicitly looking
// for deleted storages only, this can be skipped, because they will be
// retrieved from state below.
if (empty($conditions['deleted'])) {
if (isset($conditions['entity_type']) && isset($conditions['field_name'])) {
// Optimize for the most frequent case where we do have a specific ID.
$id = $conditions['entity_type'] . $conditions['field_name'];
$storages = $this
->loadMultiple(array(
$id,
));
}
else {
// No specific ID, we need to examine all existing storages.
$storages = $this
->loadMultiple();
}
}
// Merge deleted field storages (living in state) if needed.
if ($include_deleted || !empty($conditions['deleted'])) {
$deleted_storages = $this->state
->get('field.storage.deleted') ?: array();
foreach ($deleted_storages as $id => $config) {
$storages[$id] = $this
->create($config);
}
}
// Collect matching fields.
$matches = array();
foreach ($storages as $field) {
foreach ($conditions as $key => $value) {
// Extract the actual value against which the condition is checked.
$checked_value = $field
->get($key);
// Skip to the next field as soon as one condition does not match.
if ($checked_value != $value) {
continue 2;
}
}
// When returning deleted fields, key the results by UUID since they can
// include several fields with the same ID.
$key = $include_deleted ? $field
->uuid() : $field
->id();
$matches[$key] = $field;
}
return $matches;
}