trait DomainTestTrait in Domain Access 8
Contains helper classes for tests to set up various configuration.
Hierarchy
- trait \Drupal\Tests\domain\Traits\DomainTestTrait
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
File
- domain/
tests/ src/ Traits/ DomainTestTrait.php, line 8
Namespace
Drupal\Tests\domain\TraitsView 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
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DomainTestTrait:: |
public | function | Adds a test domain to an entity. | |
DomainTestTrait:: |
public | function | Generates a list of domains for testing. | |
DomainTestTrait:: |
public | function | Creates domain record for use with POST request tests. | |
DomainTestTrait:: |
public | function | Reusable test function for checking initial / empty table status. | |
DomainTestTrait:: |
public | function | Returns an uncached list of all domains. | |
DomainTestTrait:: |
public | function | Returns an uncached list of all domains, sorted by weight. | |
DomainTestTrait:: |
public | function | Converts a domain hostname to a trusted host pattern. | |
DomainTestTrait:: |
public | function | Set the base hostname for this test. | |
DomainTestTrait:: |
public | function | Set the base TLD for this test. |