interface DomainNegotiatorInterface in Domain Access 8

Handles the negotiation of the active domain record.

Hierarchy

• interface \Drupal\domain\DomainNegotiatorInterface

11 files declare their use of DomainNegotiatorInterface

CurrentDomainContext.php in domain/src/ContextProvider/CurrentDomainContext.php

Domain.php in domain/src/Entity/Domain.php

Domain.php in domain/src/Plugin/views/access/Domain.php

DomainAccessCheck.php in domain/src/Access/DomainAccessCheck.php

DomainAccessManager.php in domain_access/src/DomainAccessManager.php

... See full list

File

domain/src/DomainNegotiatorInterface.php, line 8

Namespace

Drupal\domain

interface DomainNegotiatorInterface {

  /**
   * Defines record matching types when dealing with request alteration.
   *
   * These constants are designed to help modules know how to react to a
   * domain record match, since an exact match is more important than a pattern
   * match.
   *
   * @see hook_domain_request_alter().
   *
   * No matching record found.
   */
  const DOMAIN_MATCHED_NONE = 0;

  /**
   * An exact domain record string match found.
   */
  const DOMAIN_MATCHED_EXACT = 1;

  /**
   * An alias pattern match found.
   */
  const DOMAIN_MATCHED_ALIAS = 2;

  /**
   * Determines the active domain request.
   *
   * The negotiator is passed an httpHost value, which is checked against domain
   * records for a match.
   *
   * @param string $httpHost
   *   A string representing the hostname of the request (e.g. example.com).
   * @param bool $reset
   *   Indicates whether to reset the internal cache.
   */
  public function setRequestDomain($httpHost, $reset = FALSE);

  /**
   * Sets the active domain.
   *
   * @param \Drupal\domain\DomainInterface $domain
   *   Sets the domain record as active for the duration of that request.
   */
  public function setActiveDomain(DomainInterface $domain);

  /**
   * Stores the inbound httpHost request.
   *
   * @param string $httpHost
   *   A string representing the hostname of the request (e.g. example.com).
   */
  public function setHttpHost($httpHost);

  /**
   * Gets the inbound httpHost request.
   *
   * @return string
   *   A string representing the hostname of the request (e.g. example.com).
   */
  public function getHttpHost();

  /**
   * Gets the id of the active domain.
   *
   * @return string
   *   The id of the active domain.
   */
  public function getActiveId();

  /**
   * Sets the hostname of the active request.
   *
   * This method is an internal method for use by the public getActiveDomain()
   * call. It is responsible for determining the active hostname of the request
   * and then passing that data to the negotiator.
   *
   * @return string
   *   The hostname, without the "www" if applicable.
   */
  public function negotiateActiveHostname();

  /**
   * Gets the active domain.
   *
   * This method should be called by external classes using the negotiator
   * service.
   *
   * @param bool $reset
   *   Reset the internal cache of the active domain.
   *
   * @return \Drupal\domain\DomainInterface
   *   The active domain object.
   */
  public function getActiveDomain($reset = FALSE);

  /**
   * Checks that a URL's hostname is registered as a valid domain or alias.
   *
   * @param string $hostname
   *   A string representing the hostname of the request (e.g. example.com).
   *
   * @return bool
   *   TRUE if a URL's hostname is registered as a valid domain or alias, or
   *   FALSE.
   */
  public function isRegisteredDomain($hostname);

}

Members

Name	Modifiers	Type	Description	Overrides
DomainNegotiatorInterface::DOMAIN_MATCHED_ALIAS		constant	An alias pattern match found.
DomainNegotiatorInterface::DOMAIN_MATCHED_EXACT		constant	An exact domain record string match found.
DomainNegotiatorInterface::DOMAIN_MATCHED_NONE		constant	Defines record matching types when dealing with request alteration.
DomainNegotiatorInterface::getActiveDomain	public	function	Gets the active domain.	1
DomainNegotiatorInterface::getActiveId	public	function	Gets the id of the active domain.	1
DomainNegotiatorInterface::getHttpHost	public	function	Gets the inbound httpHost request.	1
DomainNegotiatorInterface::isRegisteredDomain	public	function	Checks that a URL's hostname is registered as a valid domain or alias.	1
DomainNegotiatorInterface::negotiateActiveHostname	public	function	Sets the hostname of the active request.	1
DomainNegotiatorInterface::setActiveDomain	public	function	Sets the active domain.	1
DomainNegotiatorInterface::setHttpHost	public	function	Stores the inbound httpHost request.	1
DomainNegotiatorInterface::setRequestDomain	public	function	Determines the active domain request.	1