123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354 |
- <?php
- namespace Drupal\Core\Entity;
- use Drupal\Core\Entity\Schema\DynamicallyFieldableEntityStorageSchemaInterface;
- use Drupal\Core\Entity\Schema\EntityStorageSchemaInterface;
- use Drupal\Core\Field\BaseFieldDefinition;
- use Drupal\Core\Field\FieldStorageDefinitionInterface;
- use Drupal\Core\StringTranslation\StringTranslationTrait;
- /**
- * Manages entity definition updates.
- */
- class EntityDefinitionUpdateManager implements EntityDefinitionUpdateManagerInterface {
- use StringTranslationTrait;
- /**
- * The entity manager service.
- *
- * @var \Drupal\Core\Entity\EntityManagerInterface
- */
- protected $entityManager;
- /**
- * Constructs a new EntityDefinitionUpdateManager.
- *
- * @param \Drupal\Core\Entity\EntityManagerInterface $entity_manager
- * The entity manager.
- */
- public function __construct(EntityManagerInterface $entity_manager) {
- $this->entityManager = $entity_manager;
- }
- /**
- * {@inheritdoc}
- */
- public function needsUpdates() {
- return (bool) $this->getChangeList();
- }
- /**
- * {@inheritdoc}
- */
- public function getChangeSummary() {
- $summary = [];
- foreach ($this->getChangeList() as $entity_type_id => $change_list) {
- // Process entity type definition changes.
- if (!empty($change_list['entity_type'])) {
- $entity_type = $this->entityManager->getDefinition($entity_type_id);
- switch ($change_list['entity_type']) {
- case static::DEFINITION_CREATED:
- $summary[$entity_type_id][] = $this->t('The %entity_type entity type needs to be installed.', ['%entity_type' => $entity_type->getLabel()]);
- break;
- case static::DEFINITION_UPDATED:
- $summary[$entity_type_id][] = $this->t('The %entity_type entity type needs to be updated.', ['%entity_type' => $entity_type->getLabel()]);
- break;
- }
- }
- // Process field storage definition changes.
- if (!empty($change_list['field_storage_definitions'])) {
- $storage_definitions = $this->entityManager->getFieldStorageDefinitions($entity_type_id);
- $original_storage_definitions = $this->entityManager->getLastInstalledFieldStorageDefinitions($entity_type_id);
- foreach ($change_list['field_storage_definitions'] as $field_name => $change) {
- switch ($change) {
- case static::DEFINITION_CREATED:
- $summary[$entity_type_id][] = $this->t('The %field_name field needs to be installed.', ['%field_name' => $storage_definitions[$field_name]->getLabel()]);
- break;
- case static::DEFINITION_UPDATED:
- $summary[$entity_type_id][] = $this->t('The %field_name field needs to be updated.', ['%field_name' => $storage_definitions[$field_name]->getLabel()]);
- break;
- case static::DEFINITION_DELETED:
- $summary[$entity_type_id][] = $this->t('The %field_name field needs to be uninstalled.', ['%field_name' => $original_storage_definitions[$field_name]->getLabel()]);
- break;
- }
- }
- }
- }
- return $summary;
- }
- /**
- * {@inheritdoc}
- */
- public function applyUpdates() {
- $complete_change_list = $this->getChangeList();
- if ($complete_change_list) {
- // self::getChangeList() only disables the cache and does not invalidate.
- // In case there are changes, explicitly invalidate caches.
- $this->entityManager->clearCachedDefinitions();
- }
- foreach ($complete_change_list as $entity_type_id => $change_list) {
- // Process entity type definition changes before storage definitions ones
- // this is necessary when you change an entity type from non-revisionable
- // to revisionable and at the same time add revisionable fields to the
- // entity type.
- if (!empty($change_list['entity_type'])) {
- $this->doEntityUpdate($change_list['entity_type'], $entity_type_id);
- }
- // Process field storage definition changes.
- if (!empty($change_list['field_storage_definitions'])) {
- $storage_definitions = $this->entityManager->getFieldStorageDefinitions($entity_type_id);
- $original_storage_definitions = $this->entityManager->getLastInstalledFieldStorageDefinitions($entity_type_id);
- foreach ($change_list['field_storage_definitions'] as $field_name => $change) {
- $storage_definition = isset($storage_definitions[$field_name]) ? $storage_definitions[$field_name] : NULL;
- $original_storage_definition = isset($original_storage_definitions[$field_name]) ? $original_storage_definitions[$field_name] : NULL;
- $this->doFieldUpdate($change, $storage_definition, $original_storage_definition);
- }
- }
- }
- }
- /**
- * {@inheritdoc}
- */
- public function getEntityType($entity_type_id) {
- $entity_type = $this->entityManager->getLastInstalledDefinition($entity_type_id);
- return $entity_type ? clone $entity_type : NULL;
- }
- /**
- * {@inheritdoc}
- */
- public function installEntityType(EntityTypeInterface $entity_type) {
- $this->entityManager->clearCachedDefinitions();
- $this->entityManager->onEntityTypeCreate($entity_type);
- }
- /**
- * {@inheritdoc}
- */
- public function updateEntityType(EntityTypeInterface $entity_type) {
- $original = $this->getEntityType($entity_type->id());
- $this->entityManager->clearCachedDefinitions();
- $this->entityManager->onEntityTypeUpdate($entity_type, $original);
- }
- /**
- * {@inheritdoc}
- */
- public function uninstallEntityType(EntityTypeInterface $entity_type) {
- $this->entityManager->clearCachedDefinitions();
- $this->entityManager->onEntityTypeDelete($entity_type);
- }
- /**
- * {@inheritdoc}
- */
- public function installFieldStorageDefinition($name, $entity_type_id, $provider, FieldStorageDefinitionInterface $storage_definition) {
- // @todo Pass a mutable field definition interface when we have one. See
- // https://www.drupal.org/node/2346329.
- if ($storage_definition instanceof BaseFieldDefinition) {
- $storage_definition
- ->setName($name)
- ->setTargetEntityTypeId($entity_type_id)
- ->setProvider($provider)
- ->setTargetBundle(NULL);
- }
- $this->entityManager->clearCachedDefinitions();
- $this->entityManager->onFieldStorageDefinitionCreate($storage_definition);
- }
- /**
- * {@inheritdoc}
- */
- public function getFieldStorageDefinition($name, $entity_type_id) {
- $storage_definitions = $this->entityManager->getLastInstalledFieldStorageDefinitions($entity_type_id);
- return isset($storage_definitions[$name]) ? clone $storage_definitions[$name] : NULL;
- }
- /**
- * {@inheritdoc}
- */
- public function updateFieldStorageDefinition(FieldStorageDefinitionInterface $storage_definition) {
- $original = $this->getFieldStorageDefinition($storage_definition->getName(), $storage_definition->getTargetEntityTypeId());
- $this->entityManager->clearCachedDefinitions();
- $this->entityManager->onFieldStorageDefinitionUpdate($storage_definition, $original);
- }
- /**
- * {@inheritdoc}
- */
- public function uninstallFieldStorageDefinition(FieldStorageDefinitionInterface $storage_definition) {
- $this->entityManager->clearCachedDefinitions();
- $this->entityManager->onFieldStorageDefinitionDelete($storage_definition);
- }
- /**
- * Performs an entity type definition update.
- *
- * @param string $op
- * The operation to perform, either static::DEFINITION_CREATED or
- * static::DEFINITION_UPDATED.
- * @param string $entity_type_id
- * The entity type ID.
- */
- protected function doEntityUpdate($op, $entity_type_id) {
- $entity_type = $this->entityManager->getDefinition($entity_type_id);
- switch ($op) {
- case static::DEFINITION_CREATED:
- $this->entityManager->onEntityTypeCreate($entity_type);
- break;
- case static::DEFINITION_UPDATED:
- $original = $this->entityManager->getLastInstalledDefinition($entity_type_id);
- $this->entityManager->onEntityTypeUpdate($entity_type, $original);
- break;
- }
- }
- /**
- * Performs a field storage definition update.
- *
- * @param string $op
- * The operation to perform, possible values are static::DEFINITION_CREATED,
- * static::DEFINITION_UPDATED or static::DEFINITION_DELETED.
- * @param array|null $storage_definition
- * The new field storage definition.
- * @param array|null $original_storage_definition
- * The original field storage definition.
- */
- protected function doFieldUpdate($op, $storage_definition = NULL, $original_storage_definition = NULL) {
- switch ($op) {
- case static::DEFINITION_CREATED:
- $this->entityManager->onFieldStorageDefinitionCreate($storage_definition);
- break;
- case static::DEFINITION_UPDATED:
- $this->entityManager->onFieldStorageDefinitionUpdate($storage_definition, $original_storage_definition);
- break;
- case static::DEFINITION_DELETED:
- $this->entityManager->onFieldStorageDefinitionDelete($original_storage_definition);
- break;
- }
- }
- /**
- * Gets a list of changes to entity type and field storage definitions.
- *
- * @return array
- * An associative array keyed by entity type id of change descriptors. Every
- * entry is an associative array with the following optional keys:
- * - entity_type: a scalar having only the DEFINITION_UPDATED value.
- * - field_storage_definitions: an associative array keyed by field name of
- * scalars having one value among:
- * - DEFINITION_CREATED
- * - DEFINITION_UPDATED
- * - DEFINITION_DELETED
- */
- protected function getChangeList() {
- $this->entityManager->useCaches(FALSE);
- $change_list = [];
- foreach ($this->entityManager->getDefinitions() as $entity_type_id => $entity_type) {
- $original = $this->entityManager->getLastInstalledDefinition($entity_type_id);
- // @todo Support non-storage-schema-changing definition updates too:
- // https://www.drupal.org/node/2336895.
- if (!$original) {
- $change_list[$entity_type_id]['entity_type'] = static::DEFINITION_CREATED;
- }
- else {
- if ($this->requiresEntityStorageSchemaChanges($entity_type, $original)) {
- $change_list[$entity_type_id]['entity_type'] = static::DEFINITION_UPDATED;
- }
- if ($this->entityManager->getStorage($entity_type_id) instanceof DynamicallyFieldableEntityStorageInterface) {
- $field_changes = [];
- $storage_definitions = $this->entityManager->getFieldStorageDefinitions($entity_type_id);
- $original_storage_definitions = $this->entityManager->getLastInstalledFieldStorageDefinitions($entity_type_id);
- // Detect created field storage definitions.
- foreach (array_diff_key($storage_definitions, $original_storage_definitions) as $field_name => $storage_definition) {
- $field_changes[$field_name] = static::DEFINITION_CREATED;
- }
- // Detect deleted field storage definitions.
- foreach (array_diff_key($original_storage_definitions, $storage_definitions) as $field_name => $original_storage_definition) {
- $field_changes[$field_name] = static::DEFINITION_DELETED;
- }
- // Detect updated field storage definitions.
- foreach (array_intersect_key($storage_definitions, $original_storage_definitions) as $field_name => $storage_definition) {
- // @todo Support non-storage-schema-changing definition updates too:
- // https://www.drupal.org/node/2336895. So long as we're checking
- // based on schema change requirements rather than definition
- // equality, skip the check if the entity type itself needs to be
- // updated, since that can affect the schema of all fields, so we
- // want to process that update first without reporting false
- // positives here.
- if (!isset($change_list[$entity_type_id]['entity_type']) && $this->requiresFieldStorageSchemaChanges($storage_definition, $original_storage_definitions[$field_name])) {
- $field_changes[$field_name] = static::DEFINITION_UPDATED;
- }
- }
- if ($field_changes) {
- $change_list[$entity_type_id]['field_storage_definitions'] = $field_changes;
- }
- }
- }
- }
- // @todo Support deleting entity definitions when we support base field
- // purging.
- // @see https://www.drupal.org/node/2907779
- $this->entityManager->useCaches(TRUE);
- return array_filter($change_list);
- }
- /**
- * Checks if the changes to the entity type requires storage schema changes.
- *
- * @param \Drupal\Core\Entity\EntityTypeInterface $entity_type
- * The updated entity type definition.
- * @param \Drupal\Core\Entity\EntityTypeInterface $original
- * The original entity type definition.
- *
- * @return bool
- * TRUE if storage schema changes are required, FALSE otherwise.
- */
- protected function requiresEntityStorageSchemaChanges(EntityTypeInterface $entity_type, EntityTypeInterface $original) {
- $storage = $this->entityManager->getStorage($entity_type->id());
- return ($storage instanceof EntityStorageSchemaInterface) && $storage->requiresEntityStorageSchemaChanges($entity_type, $original);
- }
- /**
- * Checks if the changes to the storage definition requires schema changes.
- *
- * @param \Drupal\Core\Field\FieldStorageDefinitionInterface $storage_definition
- * The updated field storage definition.
- * @param \Drupal\Core\Field\FieldStorageDefinitionInterface $original
- * The original field storage definition.
- *
- * @return bool
- * TRUE if storage schema changes are required, FALSE otherwise.
- */
- protected function requiresFieldStorageSchemaChanges(FieldStorageDefinitionInterface $storage_definition, FieldStorageDefinitionInterface $original) {
- $storage = $this->entityManager->getStorage($storage_definition->getTargetEntityTypeId());
- return ($storage instanceof DynamicallyFieldableEntityStorageSchemaInterface) && $storage->requiresFieldStorageSchemaChanges($storage_definition, $original);
- }
- }
|