class QueryAccessEvent in Entity API 8

Defines the query access event.

Allows modules to modify access conditions before they're applied to a query.

The event ID is both generic and dynamic:

• entity.query_access
• entity.query_access.$entity_type_id

Hierarchy

• class \Drupal\entity\QueryAccess\QueryAccessEvent extends \Symfony\Component\EventDispatcher\Event

1 file declares its use of QueryAccessEvent

QueryAccessSubscriber.php in tests/modules/entity_module_test/src/EventSubscriber/QueryAccessSubscriber.php

File

src/QueryAccess/QueryAccessEvent.php, line 17

Namespace

Drupal\entity\QueryAccess

class QueryAccessEvent extends Event {

  /**
   * The conditions.
   *
   * @var \Drupal\entity\QueryAccess\ConditionGroup
   */
  protected $conditions;

  /**
   * The operation.
   *
   * @var string
   */
  protected $operation;

  /**
   * The user for which to restrict access.
   *
   * @var \Drupal\Core\Session\AccountInterface
   */
  protected $account;

  /**
   * The ID of entity type the query is for.
   *
   * @var string
   */
  protected $entityTypeId;

  /**
   * Constructs a new QueryAccessEvent.
   *
   * @param \Drupal\entity\QueryAccess\ConditionGroup $conditions
   *   The conditions.
   * @param string $operation
   *   The operation. Usually one of "view", "update", "duplicate", or "delete".
   * @param \Drupal\Core\Session\AccountInterface $account
   *   The user for which to restrict access.
   * @param string $entity_type_id
   *   The ID of entity type the query is for.
   */
  public function __construct(ConditionGroup $conditions, $operation, AccountInterface $account, $entity_type_id = NULL) {
    $this->conditions = $conditions;
    $this->operation = $operation;
    $this->account = $account;
    if (!isset($entity_type_id)) {
      @trigger_error('The $entity_type_id argument must be passed to QueryAccessEvent::__construct(), it is required before entity:2.0.0. See https://www.drupal.org/node/3134363.', E_USER_DEPRECATED);
    }
    else {
      $this->entityTypeId = $entity_type_id;
    }
  }

  /**
   * Gets the conditions.
   *
   * If $conditions->isAlwaysFalse() is TRUE, the user doesn't have access to
   * any entities, and the query is expected to return no results.
   * This can be reversed by calling $conditions->alwaysFalse(FALSE).
   *
   * If $conditions->isAlwaysFalse() is FALSE, and the condition group is
   * empty (count is 0), the user has full access, and the query doesn't
   * need to be restricted.
   *
   * @return \Drupal\entity\QueryAccess\ConditionGroup
   *   The conditions.
   */
  public function getConditions() {
    return $this->conditions;
  }

  /**
   * Gets the operation.
   *
   * @return string
   *   The operation. Usually one of "view", "update" or "delete".
   */
  public function getOperation() {
    return $this->operation;
  }

  /**
   * Gets the user for which to restrict access.
   *
   * @return \Drupal\Core\Session\AccountInterface
   *   The user.
   */
  public function getAccount() {
    return $this->account;
  }

  /**
   * Gets the the entity type ID.
   *
   * @return string
   *   The entity type ID.
   */
  public function getEntityTypeId() {
    return $this->entityTypeId;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
QueryAccessEvent::$account	protected	property	The user for which to restrict access.
QueryAccessEvent::$conditions	protected	property	The conditions.
QueryAccessEvent::$entityTypeId	protected	property	The ID of entity type the query is for.
QueryAccessEvent::$operation	protected	property	The operation.
QueryAccessEvent::getAccount	public	function	Gets the user for which to restrict access.
QueryAccessEvent::getConditions	public	function	Gets the conditions.
QueryAccessEvent::getEntityTypeId	public	function	Gets the the entity type ID.
QueryAccessEvent::getOperation	public	function	Gets the operation.
QueryAccessEvent::__construct	public	function	Constructs a new QueryAccessEvent.