class WorkspaceManager

Same name and namespace in other branches
  1. 8.9.x core/modules/workspaces/src/WorkspaceManager.php \Drupal\workspaces\WorkspaceManager
  2. 10 core/modules/workspaces/src/WorkspaceManager.php \Drupal\workspaces\WorkspaceManager
  3. 11.x core/modules/workspaces/src/WorkspaceManager.php \Drupal\workspaces\WorkspaceManager

Provides the workspace manager.

Hierarchy

Expanded class hierarchy of WorkspaceManager

1 string reference to 'WorkspaceManager'
workspaces.services.yml in core/modules/workspaces/workspaces.services.yml
core/modules/workspaces/workspaces.services.yml
1 service uses WorkspaceManager
workspaces.manager in core/modules/workspaces/workspaces.services.yml
Drupal\workspaces\WorkspaceManager

File

core/modules/workspaces/src/WorkspaceManager.php, line 20

Namespace

Drupal\workspaces
View source
class WorkspaceManager implements WorkspaceManagerInterface {
    use StringTranslationTrait;
    
    /**
     * An array of which entity types are supported.
     *
     * @var string[]
     */
    protected $supported = [
        'workspace' => FALSE,
    ];
    
    /**
     * The request stack.
     *
     * @var \Symfony\Component\HttpFoundation\RequestStack
     */
    protected $requestStack;
    
    /**
     * The entity type manager.
     *
     * @var \Drupal\Core\Entity\EntityTypeManagerInterface
     */
    protected $entityTypeManager;
    
    /**
     * The entity memory cache service.
     *
     * @var \Drupal\Core\Cache\MemoryCache\MemoryCacheInterface
     */
    protected $entityMemoryCache;
    
    /**
     * The current user.
     *
     * @var \Drupal\Core\Session\AccountProxyInterface
     */
    protected $currentUser;
    
    /**
     * The state service.
     *
     * @var \Drupal\Core\State\StateInterface
     */
    protected $state;
    
    /**
     * A logger instance.
     *
     * @var \Psr\Log\LoggerInterface
     */
    protected $logger;
    
    /**
     * The class resolver.
     *
     * @var \Drupal\Core\DependencyInjection\ClassResolverInterface
     */
    protected $classResolver;
    
    /**
     * The workspace association service.
     *
     * @var \Drupal\workspaces\WorkspaceAssociationInterface
     */
    protected $workspaceAssociation;
    
    /**
     * The workspace negotiator service IDs.
     *
     * @var array
     */
    protected $negotiatorIds;
    
    /**
     * The current active workspace or FALSE if there is no active workspace.
     *
     * @var \Drupal\workspaces\WorkspaceInterface|false
     */
    protected $activeWorkspace;
    
    /**
     * Constructs a new WorkspaceManager.
     *
     * @param \Symfony\Component\HttpFoundation\RequestStack $request_stack
     *   The request stack.
     * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
     *   The entity type manager.
     * @param \Drupal\Core\Cache\MemoryCache\MemoryCacheInterface $entity_memory_cache
     *   The entity memory cache service.
     * @param \Drupal\Core\Session\AccountProxyInterface $current_user
     *   The current user.
     * @param \Drupal\Core\State\StateInterface $state
     *   The state service.
     * @param \Psr\Log\LoggerInterface $logger
     *   A logger instance.
     * @param \Drupal\Core\DependencyInjection\ClassResolverInterface $class_resolver
     *   The class resolver.
     * @param \Drupal\workspaces\WorkspaceAssociationInterface $workspace_association
     *   The workspace association service.
     * @param array $negotiator_ids
     *   The workspace negotiator service IDs.
     */
    public function __construct(RequestStack $request_stack, EntityTypeManagerInterface $entity_type_manager, MemoryCacheInterface $entity_memory_cache, AccountProxyInterface $current_user, StateInterface $state, LoggerInterface $logger, ClassResolverInterface $class_resolver, WorkspaceAssociationInterface $workspace_association, array $negotiator_ids) {
        $this->requestStack = $request_stack;
        $this->entityTypeManager = $entity_type_manager;
        $this->entityMemoryCache = $entity_memory_cache;
        $this->currentUser = $current_user;
        $this->state = $state;
        $this->logger = $logger;
        $this->classResolver = $class_resolver;
        $this->workspaceAssociation = $workspace_association;
        $this->negotiatorIds = $negotiator_ids;
    }
    
    /**
     * {@inheritdoc}
     */
    public function isEntityTypeSupported(EntityTypeInterface $entity_type) {
        $entity_type_id = $entity_type->id();
        if (!isset($this->supported[$entity_type_id])) {
            // Only entity types which are revisionable and publishable can belong
            // to a workspace.
            $this->supported[$entity_type_id] = $entity_type->entityClassImplements(EntityPublishedInterface::class) && $entity_type->isRevisionable();
        }
        return $this->supported[$entity_type_id];
    }
    
    /**
     * {@inheritdoc}
     */
    public function getSupportedEntityTypes() {
        $entity_types = [];
        foreach ($this->entityTypeManager
            ->getDefinitions() as $entity_type_id => $entity_type) {
            if ($this->isEntityTypeSupported($entity_type)) {
                $entity_types[$entity_type_id] = $entity_type;
            }
        }
        return $entity_types;
    }
    
    /**
     * {@inheritdoc}
     */
    public function hasActiveWorkspace() {
        return $this->getActiveWorkspace() !== FALSE;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getActiveWorkspace() {
        if (!isset($this->activeWorkspace)) {
            $request = $this->requestStack
                ->getCurrentRequest();
            foreach ($this->negotiatorIds as $negotiator_id) {
                $negotiator = $this->classResolver
                    ->getInstanceFromDefinition($negotiator_id);
                if ($negotiator->applies($request)) {
                    // By default, 'view' access is checked when a workspace is activated,
                    // but it should also be checked when retrieving the currently active
                    // workspace.
                    if (($negotiated_workspace = $negotiator->getActiveWorkspace($request)) && $negotiated_workspace->access('view')) {
                        $active_workspace = $negotiated_workspace;
                        break;
                    }
                }
            }
            // If no negotiator was able to determine the active workspace, default to
            // the live version of the site.
            $this->activeWorkspace = $active_workspace ?? FALSE;
        }
        return $this->activeWorkspace;
    }
    
    /**
     * {@inheritdoc}
     */
    public function setActiveWorkspace(WorkspaceInterface $workspace) {
        $this->doSwitchWorkspace($workspace);
        // Set the workspace on the proper negotiator.
        $request = $this->requestStack
            ->getCurrentRequest();
        foreach ($this->negotiatorIds as $negotiator_id) {
            $negotiator = $this->classResolver
                ->getInstanceFromDefinition($negotiator_id);
            if ($negotiator->applies($request)) {
                $negotiator->setActiveWorkspace($workspace);
                break;
            }
        }
        return $this;
    }
    
    /**
     * {@inheritdoc}
     */
    public function switchToLive() {
        $this->doSwitchWorkspace(NULL);
        // Unset the active workspace on all negotiators.
        foreach ($this->negotiatorIds as $negotiator_id) {
            $negotiator = $this->classResolver
                ->getInstanceFromDefinition($negotiator_id);
            $negotiator->unsetActiveWorkspace();
        }
        return $this;
    }
    
    /**
     * Switches the current workspace.
     *
     * @param \Drupal\workspaces\WorkspaceInterface|null $workspace
     *   The workspace to set as active or NULL to switch out of the currently
     *   active workspace.
     *
     * @throws \Drupal\workspaces\WorkspaceAccessException
     *   Thrown when the current user doesn't have access to view the workspace.
     */
    protected function doSwitchWorkspace($workspace) {
        // If the current user doesn't have access to view the workspace, they
        // shouldn't be allowed to switch to it, except in CLI processes.
        if ($workspace && PHP_SAPI !== 'cli' && !$workspace->access('view')) {
            $this->logger
                ->error('Denied access to view workspace %workspace_label for user %uid', [
                '%workspace_label' => $workspace->label(),
                '%uid' => $this->currentUser
                    ->id(),
            ]);
            throw new WorkspaceAccessException('The user does not have permission to view that workspace.');
        }
        $this->activeWorkspace = $workspace ?: FALSE;
        // Clear the static entity cache for the supported entity types.
        $cache_tags_to_invalidate = array_map(function ($entity_type_id) {
            return 'entity.memory_cache:' . $entity_type_id;
        }, array_keys($this->getSupportedEntityTypes()));
        $this->entityMemoryCache
            ->invalidateTags($cache_tags_to_invalidate);
        // Clear the static cache for path aliases. We can't inject the path alias
        // manager service because it would create a circular dependency.
        \Drupal::service('path_alias.manager')->cacheClear();
    }
    
    /**
     * {@inheritdoc}
     */
    public function executeInWorkspace($workspace_id, callable $function) {
        
        /** @var \Drupal\workspaces\WorkspaceInterface $workspace */
        $workspace = $this->entityTypeManager
            ->getStorage('workspace')
            ->load($workspace_id);
        if (!$workspace) {
            throw new \InvalidArgumentException('The ' . $workspace_id . ' workspace does not exist.');
        }
        $previous_active_workspace = $this->getActiveWorkspace();
        $this->doSwitchWorkspace($workspace);
        $result = $function();
        $this->doSwitchWorkspace($previous_active_workspace);
        return $result;
    }
    
    /**
     * {@inheritdoc}
     */
    public function executeOutsideWorkspace(callable $function) {
        $previous_active_workspace = $this->getActiveWorkspace();
        $this->doSwitchWorkspace(NULL);
        $result = $function();
        $this->doSwitchWorkspace($previous_active_workspace);
        return $result;
    }
    
    /**
     * {@inheritdoc}
     */
    public function shouldAlterOperations(EntityTypeInterface $entity_type) {
        return $this->isEntityTypeSupported($entity_type) && $this->hasActiveWorkspace();
    }
    
    /**
     * {@inheritdoc}
     */
    public function purgeDeletedWorkspacesBatch() {
        $deleted_workspace_ids = $this->state
            ->get('workspace.deleted', []);
        // Bail out early if there are no workspaces to purge.
        if (empty($deleted_workspace_ids)) {
            return;
        }
        $batch_size = Settings::get('entity_update_batch_size', 50);
        // Get the first deleted workspace from the list and delete the revisions
        // associated with it, along with the workspace association records.
        $workspace_id = reset($deleted_workspace_ids);
        $tracked_entities = $this->workspaceAssociation
            ->getTrackedEntities($workspace_id);
        $count = 1;
        foreach ($tracked_entities as $entity_type_id => $entities) {
            $associated_entity_storage = $this->entityTypeManager
                ->getStorage($entity_type_id);
            $associated_revisions = $this->workspaceAssociation
                ->getAssociatedRevisions($workspace_id, $entity_type_id);
            foreach (array_keys($associated_revisions) as $revision_id) {
                if ($count > $batch_size) {
                    continue 2;
                }
                // Delete the associated entity revision.
                $associated_entity_storage->deleteRevision($revision_id);
                $count++;
            }
            // Delete the workspace association entries.
            $this->workspaceAssociation
                ->deleteAssociations($workspace_id, $entity_type_id, $entities);
        }
        // The purging operation above might have taken a long time, so we need to
        // request a fresh list of tracked entities. If it is empty, we can go ahead
        // and remove the deleted workspace ID entry from state.
        if (!$this->workspaceAssociation
            ->getTrackedEntities($workspace_id)) {
            unset($deleted_workspace_ids[$workspace_id]);
            $this->state
                ->set('workspace.deleted', $deleted_workspace_ids);
        }
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
StringTranslationTrait::$stringTranslation protected property The string translation service. 3
StringTranslationTrait::formatPlural protected function Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals protected function Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation protected function Gets the string translation service.
StringTranslationTrait::setStringTranslation public function Sets the string translation service to use. 2
StringTranslationTrait::t protected function Translates a string to the current language or to a given language.
WorkspaceManager::$activeWorkspace protected property The current active workspace or FALSE if there is no active workspace.
WorkspaceManager::$classResolver protected property The class resolver.
WorkspaceManager::$currentUser protected property The current user.
WorkspaceManager::$entityMemoryCache protected property The entity memory cache service.
WorkspaceManager::$entityTypeManager protected property The entity type manager.
WorkspaceManager::$logger protected property A logger instance.
WorkspaceManager::$negotiatorIds protected property The workspace negotiator service IDs.
WorkspaceManager::$requestStack protected property The request stack.
WorkspaceManager::$state protected property The state service.
WorkspaceManager::$supported protected property An array of which entity types are supported.
WorkspaceManager::$workspaceAssociation protected property The workspace association service.
WorkspaceManager::doSwitchWorkspace protected function Switches the current workspace.
WorkspaceManager::executeInWorkspace public function Executes the given callback function in the context of a workspace. Overrides WorkspaceManagerInterface::executeInWorkspace
WorkspaceManager::executeOutsideWorkspace public function Executes the given callback function without any workspace context. Overrides WorkspaceManagerInterface::executeOutsideWorkspace
WorkspaceManager::getActiveWorkspace public function Gets the active workspace. Overrides WorkspaceManagerInterface::getActiveWorkspace
WorkspaceManager::getSupportedEntityTypes public function Returns an array of entity types that can belong to workspaces. Overrides WorkspaceManagerInterface::getSupportedEntityTypes
WorkspaceManager::hasActiveWorkspace public function Determines whether a workspace is active in the current request. Overrides WorkspaceManagerInterface::hasActiveWorkspace
WorkspaceManager::isEntityTypeSupported public function Returns whether an entity type can belong to a workspace or not. Overrides WorkspaceManagerInterface::isEntityTypeSupported
WorkspaceManager::purgeDeletedWorkspacesBatch public function Deletes the revisions associated with deleted workspaces. Overrides WorkspaceManagerInterface::purgeDeletedWorkspacesBatch
WorkspaceManager::setActiveWorkspace public function Sets the active workspace via the workspace negotiators. Overrides WorkspaceManagerInterface::setActiveWorkspace
WorkspaceManager::shouldAlterOperations public function Determines whether runtime entity operations should be altered. Overrides WorkspaceManagerInterface::shouldAlterOperations
WorkspaceManager::switchToLive public function Unsets the active workspace via the workspace negotiators. Overrides WorkspaceManagerInterface::switchToLive
WorkspaceManager::__construct public function Constructs a new WorkspaceManager.

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