class BootstrapTrustedHostsTestCase
Test the trusted HTTP host configuration.
Hierarchy
- class \DrupalTestCase
- class \DrupalUnitTestCase extends \DrupalTestCase
- class \BootstrapTrustedHostsTestCase extends \DrupalUnitTestCase
 
 
 - class \DrupalUnitTestCase extends \DrupalTestCase
 
Expanded class hierarchy of BootstrapTrustedHostsTestCase
File
- 
              modules/
simpletest/ tests/ bootstrap.test, line 970  
View source
class BootstrapTrustedHostsTestCase extends DrupalUnitTestCase {
  public static function getInfo() {
    return array(
      'name' => 'Trusted HTTP host test',
      'description' => 'Tests the trusted_host_patterns configuration.',
      'group' => 'Bootstrap',
    );
  }
  
  /**
   * Tests hostname validation.
   *
   * @see drupal_check_trusted_hosts()
   */
  function testTrustedHosts() {
    $trusted_host_patterns = array(
      '^example\\.com$',
      '^.+\\.example\\.com$',
      '^example\\.org',
      '^.+\\.example\\.org',
    );
    foreach ($this->providerTestTrustedHosts() as $data) {
      $test = array_combine(array(
        'host',
        'message',
        'expected',
      ), $data);
      $valid_host = drupal_check_trusted_hosts($test['host'], $trusted_host_patterns);
      $this->assertEqual($test['expected'], $valid_host, $test['message']);
    }
  }
  
  /**
   * Provides test data for testTrustedHosts().
   */
  public function providerTestTrustedHosts() {
    $data = array();
    // Tests canonical URL.
    $data[] = array(
      'www.example.com',
      'canonical URL is trusted',
      TRUE,
    );
    // Tests missing hostname for HTTP/1.0 compatability where the Host
    // header is optional.
    $data[] = array(
      NULL,
      'empty Host is valid',
      TRUE,
    );
    // Tests the additional patterns from the settings.
    $data[] = array(
      'example.com',
      'host from settings is trusted',
      TRUE,
    );
    $data[] = array(
      'subdomain.example.com',
      'host from settings is trusted',
      TRUE,
    );
    $data[] = array(
      'www.example.org',
      'host from settings is trusted',
      TRUE,
    );
    $data[] = array(
      'example.org',
      'host from settings is trusted',
      TRUE,
    );
    // Tests mismatch.
    $data[] = array(
      'www.blackhat.com',
      'unspecified host is untrusted',
      FALSE,
    );
    return $data;
  }
}
Members
| Title Sort descending | Modifiers | Object type | Summary | Overriden Title | Overrides | 
|---|---|---|---|---|---|
| BootstrapTrustedHostsTestCase::getInfo | public static | function | |||
| BootstrapTrustedHostsTestCase::providerTestTrustedHosts | public | function | Provides test data for testTrustedHosts(). | ||
| BootstrapTrustedHostsTestCase::testTrustedHosts | function | Tests hostname validation. | |||
| DrupalTestCase::$assertions | protected | property | Assertions thrown in that test case. | ||
| DrupalTestCase::$databasePrefix | protected | property | The database prefix of this test run. | ||
| DrupalTestCase::$originalFileDirectory | protected | property | The original file directory, before it was changed for testing purposes. | ||
| DrupalTestCase::$originalLanguage | protected | property | The original language. | ||
| DrupalTestCase::$originalLanguageDefault | protected | property | The original default language. | ||
| DrupalTestCase::$originalTheme | protected | property | The original theme. | ||
| DrupalTestCase::$originalThemeKey | protected | property | The original theme key. | ||
| DrupalTestCase::$originalThemePath | protected | property | The original theme path. | ||
| DrupalTestCase::$results | public | property | Current results of this test case. | ||
| DrupalTestCase::$setup | protected | property | Flag to indicate whether the test has been set up. | ||
| DrupalTestCase::$setupDatabasePrefix | protected | property | |||
| DrupalTestCase::$setupEnvironment | protected | property | |||
| DrupalTestCase::$skipClasses | protected | property | This class is skipped when looking for the source of an assertion. | ||
| DrupalTestCase::$testId | protected | property | The test run ID. | ||
| DrupalTestCase::$timeLimit | protected | property | Time limit for the test. | ||
| DrupalTestCase::$useSetupInstallationCache | public | property | Whether to cache the installation part of the setUp() method. | ||
| DrupalTestCase::$useSetupModulesCache | public | property | Whether to cache the modules installation part of the setUp() method. | ||
| DrupalTestCase::$verboseDirectoryUrl | protected | property | URL to the verbose output file directory. | ||
| DrupalTestCase::assert | protected | function | Internal helper: stores the assert. | ||
| DrupalTestCase::assertEqual | protected | function | Check to see if two values are equal. | ||
| DrupalTestCase::assertFalse | protected | function | Check to see if a value is false (an empty string, 0, NULL, or FALSE). | ||
| DrupalTestCase::assertIdentical | protected | function | Check to see if two values are identical. | ||
| DrupalTestCase::assertNotEqual | protected | function | Check to see if two values are not equal. | ||
| DrupalTestCase::assertNotIdentical | protected | function | Check to see if two values are not identical. | ||
| DrupalTestCase::assertNotNull | protected | function | Check to see if a value is not NULL. | ||
| DrupalTestCase::assertNull | protected | function | Check to see if a value is NULL. | ||
| DrupalTestCase::assertTrue | protected | function | Check to see if a value is not false (not an empty string, 0, NULL, or FALSE). | ||
| DrupalTestCase::deleteAssert | public static | function | Delete an assertion record by message ID. | ||
| DrupalTestCase::error | protected | function | Fire an error assertion. | 1 | |
| DrupalTestCase::errorHandler | public | function | Handle errors during test runs. | 1 | |
| DrupalTestCase::exceptionHandler | protected | function | Handle exceptions. | ||
| DrupalTestCase::fail | protected | function | Fire an assertion that is always negative. | ||
| DrupalTestCase::generatePermutations | public static | function | Converts a list of possible parameters into a stack of permutations. | ||
| DrupalTestCase::getAssertionCall | protected | function | Cycles through backtrace until the first non-assertion method is found. | ||
| DrupalTestCase::getDatabaseConnection | public static | function | Returns the database connection to the site running Simpletest. | ||
| DrupalTestCase::insertAssert | public static | function | Store an assertion from outside the testing context. | ||
| DrupalTestCase::pass | protected | function | Fire an assertion that is always positive. | ||
| DrupalTestCase::randomName | public static | function | Generates a random string containing letters and numbers. | ||
| DrupalTestCase::randomString | public static | function | Generates a random string of ASCII characters of codes 32 to 126. | ||
| DrupalTestCase::run | public | function | Run all tests in this class. | ||
| DrupalTestCase::verbose | protected | function | Logs a verbose message in a text file. | ||
| DrupalUnitTestCase::setUp | protected | function | Sets up unit test environment. | 12 | |
| DrupalUnitTestCase::tearDown | protected | function | 1 | ||
| DrupalUnitTestCase::__construct | function | Constructor for DrupalUnitTestCase. | Overrides DrupalTestCase::__construct | 
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.