You are here

trait DomainTestTrait in Domain Access 8

Contains helper classes for tests to set up various configuration.

Hierarchy

7 files declare their use of DomainTestTrait
ActiveDomainDefaultArgumentTest.php in domain/tests/src/Functional/Views/ActiveDomainDefaultArgumentTest.php
DomainConfigUIOverrideTest.php in domain_config_ui/tests/src/FunctionalJavascript/DomainConfigUIOverrideTest.php
DomainConfigUiSavedConfigTest.php in domain_config_ui/tests/src/FunctionalJavascript/DomainConfigUiSavedConfigTest.php
DomainConfigUISettingsTest.php in domain_config_ui/tests/src/FunctionalJavascript/DomainConfigUISettingsTest.php
DomainHookTest.php in domain/tests/src/Kernel/DomainHookTest.php

... See full list

File

domain/tests/src/Traits/DomainTestTrait.php, line 8

Namespace

Drupal\Tests\domain\Traits
View source
trait DomainTestTrait {

  /**
   * Generates a list of domains for testing.
   *
   * In my environment, I use the example.local hostname as a base. Then I name
   * hostnames one.* two.* up to ten. Note that we always use *_example_com
   * for the machine_name (entity id) value, though the hostname can vary
   * based on the system. This naming allows us to load test schema files.
   *
   * The script may also add test1, test2, test3 up to any number to test a
   * large number of domains.
   *
   * @param int $count
   *   The number of domains to create.
   * @param string|null $base_hostname
   *   The root domain to use for domain creation (e.g. example.com). You should
   *   normally leave this blank to account for alternate test environments.
   * @param array $list
   *   An optional list of subdomains to apply instead of the default set.
   */
  public function domainCreateTestDomains($count = 1, $base_hostname = NULL, array $list = []) {
    $original_domains = \Drupal::entityTypeManager()
      ->getStorage('domain')
      ->loadMultiple(NULL, TRUE);
    if (empty($base_hostname)) {
      $base_hostname = $this->baseHostname;
    }

    // Note: these domains are rigged to work on my test server.
    // For proper testing, yours should be set up similarly, but you can pass a
    // $list array to change the default.
    if (empty($list)) {
      $list = [
        '',
        'one',
        'two',
        'three',
        'four',
        'five',
        'six',
        'seven',
        'eight',
        'nine',
        'ten',
      ];
    }
    for ($i = 0; $i < $count; $i++) {
      if ($i === 0) {
        $hostname = $base_hostname;
        $machine_name = 'example.com';
        $name = 'Example';
      }
      elseif (!empty($list[$i])) {
        $hostname = $list[$i] . '.' . $base_hostname;
        $machine_name = $list[$i] . '.example.com';
        $name = 'Test ' . ucfirst($list[$i]);
      }
      else {
        $hostname = 'test' . $i . '.' . $base_hostname;
        $machine_name = 'test' . $i . '.example.com';
        $name = 'Test ' . $i;
      }

      // Create a new domain programmatically.
      $values = [
        'hostname' => $hostname,
        'name' => $name,
        'id' => \Drupal::entityTypeManager()
          ->getStorage('domain')
          ->createMachineName($machine_name),
      ];
      $domain = \Drupal::entityTypeManager()
        ->getStorage('domain')
        ->create($values);
      $domain
        ->save();
    }
    $domains = \Drupal::entityTypeManager()
      ->getStorage('domain')
      ->loadMultiple(NULL, TRUE);
  }

  /**
   * Adds a test domain to an entity.
   *
   * @param string $entity_type
   *   The entity type being acted upon.
   * @param int $entity_id
   *   The entity id.
   * @param array|string $ids
   *   An id or array of ids to add.
   * @param string $field
   *   The name of the domain field used to attach to the entity.
   */
  public function addDomainsToEntity($entity_type, $entity_id, $ids, $field) {
    if ($entity = \Drupal::entityTypeManager()
      ->getStorage($entity_type)
      ->load($entity_id)) {
      $entity
        ->set($field, $ids);
      $entity
        ->save();
    }
  }

  /**
   * Returns an uncached list of all domains.
   *
   * @return array
   *   An array of domain entities.
   */
  public function getDomains() {
    \Drupal::entityTypeManager()
      ->getStorage('domain')
      ->resetCache();
    return \Drupal::entityTypeManager()
      ->getStorage('domain')
      ->loadMultiple();
  }

  /**
   * Returns an uncached list of all domains, sorted by weight.
   *
   * @return array
   *   An array of domain entities.
   */
  public function getDomainsSorted() {
    \Drupal::entityTypeManager()
      ->getStorage('domain')
      ->resetCache();
    return \Drupal::entityTypeManager()
      ->getStorage('domain')
      ->loadMultipleSorted();
  }

  /**
   * Converts a domain hostname to a trusted host pattern.
   *
   * @param string $hostname
   *   A hostname string.
   *
   * @return string
   *   A regex-safe hostname, without delimiters.
   */
  public function prepareTrustedHostname($hostname) {
    $hostname = mb_strtolower(preg_replace('/:\\d+$/', '', trim($hostname)));
    return preg_quote($hostname);
  }

  /**
   * Set the base hostname for this test.
   */
  public function setBaseHostname() {
    $this->baseHostname = \Drupal::entityTypeManager()
      ->getStorage('domain')
      ->createHostname();
    $this
      ->setBaseTLD();
  }

  /**
   * Set the base TLD for this test.
   */
  public function setBaseTLD() {
    $hostname = $this->baseHostname;
    $parts = explode('.', $hostname);
    $this->baseTLD = array_pop($parts);
  }

  /**
   * Reusable test function for checking initial / empty table status.
   */
  public function domainTableIsEmpty() {
    $domains = \Drupal::entityTypeManager()
      ->getStorage('domain')
      ->loadMultiple(NULL, TRUE);
    $this
      ->assertEmpty($domains, 'No domains have been created.');
    $default_id = \Drupal::entityTypeManager()
      ->getStorage('domain')
      ->loadDefaultId();
    $this
      ->assertEmpty($default_id, 'No default domain has been set.');
  }

  /**
   * Creates domain record for use with POST request tests.
   */
  public function domainPostValues() {
    $edit = [];
    $domain = \Drupal::entityTypeManager()
      ->getStorage('domain')
      ->create();
    $required = \Drupal::service('domain.validator')
      ->getRequiredFields();
    foreach ($required as $key) {
      $edit[$key] = $domain
        ->get($key);
    }

    // URL validation has issues on Travis, so only do it when requested.
    $edit['validate_url'] = 0;
    $edit['id'] = \Drupal::entityTypeManager()
      ->getStorage('domain')
      ->createMachineName($edit['hostname']);
    return $edit;
  }

}

Members

Namesort descending Modifiers Type Description Overrides
DomainTestTrait::addDomainsToEntity public function Adds a test domain to an entity.
DomainTestTrait::domainCreateTestDomains public function Generates a list of domains for testing.
DomainTestTrait::domainPostValues public function Creates domain record for use with POST request tests.
DomainTestTrait::domainTableIsEmpty public function Reusable test function for checking initial / empty table status.
DomainTestTrait::getDomains public function Returns an uncached list of all domains.
DomainTestTrait::getDomainsSorted public function Returns an uncached list of all domains, sorted by weight.
DomainTestTrait::prepareTrustedHostname public function Converts a domain hostname to a trusted host pattern.
DomainTestTrait::setBaseHostname public function Set the base hostname for this test.
DomainTestTrait::setBaseTLD public function Set the base TLD for this test.