class TrustedHostsRequestFactory in Drupal 8

Provides a request factory for requests using host verification.

Because the trusted host patterns for requests are stored statically, they are consulted even for fake request created with Request::create(), whose host is 'localhost' by default. Such requests would fail host verification unless 'localhost' matches one of the trusted host patterns. To circumvent this problem, this factory injects the server variables from the main request into each newly created request, so that the host is correctly set even for fake requests and they properly pass host verification.

Hierarchy

• class \Drupal\Core\Http\TrustedHostsRequestFactory

See also

\Drupal\Core\DrupalKernel::setupTrustedHosts()

2 files declare their use of TrustedHostsRequestFactory

DrupalKernel.php in core/lib/Drupal/Core/DrupalKernel.php

TrustedHostsRequestFactoryTest.php in core/tests/Drupal/Tests/Core/Http/TrustedHostsRequestFactoryTest.php

File

core/lib/Drupal/Core/Http/TrustedHostsRequestFactory.php, line 20

Namespace

Drupal\Core\Http

class TrustedHostsRequestFactory {

  /**
   * The host of the main request.
   *
   * @var string
   */
  protected $host;

  /**
   * Creates a new TrustedHostsRequestFactory.
   *
   * @param string $host
   *   The host of the main request.
   */
  public function __construct($host) {
    $this->host = (string) $host;
  }

  /**
   * Creates a new request object.
   *
   * @param array $query
   *   (optional) The query (GET) or request (POST) parameters.
   * @param array $request
   *   (optional) An array of request variables.
   * @param array $attributes
   *   (optional) An array of attributes.
   * @param array $cookies
   *   (optional) The request cookies ($_COOKIE).
   * @param array $files
   *   (optional) The request files ($_FILES).
   * @param array $server
   *   (optional) The server parameters ($_SERVER).
   * @param string $content
   *   (optional) The raw body data.
   *
   * @return \Symfony\Component\HttpFoundation\Request
   *   A new request object.
   */
  public function createRequest(array $query = [], array $request = [], array $attributes = [], array $cookies = [], array $files = [], array $server = [], $content = NULL) {
    if (empty($server['HTTP_HOST']) || $server['HTTP_HOST'] === 'localhost' && $this->host !== 'localhost') {
      $server['HTTP_HOST'] = $this->host;
    }
    return new Request($query, $request, $attributes, $cookies, $files, $server, $content);
  }

}

Members

Name	Modifiers	Type	Description	Overrides
TrustedHostsRequestFactory::$host	protected	property	The host of the main request.
TrustedHostsRequestFactory::createRequest	public	function	Creates a new request object.
TrustedHostsRequestFactory::__construct	public	function	Creates a new TrustedHostsRequestFactory.