class RequestContext in Zircon Profile 8

Holds information about the current request.

This class implements a fluent interface.

@author Fabien Potencier <[e-mail]> @author Tobias Schultze <http://tobion.de>

Hierarchy

• class \Symfony\Component\Routing\RequestContext

26 files declare their use of RequestContext

AccessAwareRouter.php in core/lib/Drupal/Core/Routing/AccessAwareRouter.php

Contains \Drupal\Core\Routing\AccessAwareRouter.

ChainRouter.php in vendor/symfony-cmf/routing/ChainRouter.php

ChainRouterTest.php in vendor/symfony-cmf/routing/Tests/Routing/ChainRouterTest.php

DynamicRouter.php in vendor/symfony-cmf/routing/DynamicRouter.php

LegacyApacheUrlMatcherTest.php in vendor/symfony/routing/Tests/Matcher/LegacyApacheUrlMatcherTest.php

... See full list

File

vendor/symfony/routing/RequestContext.php, line 24

Namespace

Symfony\Component\Routing

class RequestContext {
  private $baseUrl;
  private $pathInfo;
  private $method;
  private $host;
  private $scheme;
  private $httpPort;
  private $httpsPort;
  private $queryString;

  /**
   * @var array
   */
  private $parameters = array();

  /**
   * Constructor.
   *
   * @param string $baseUrl     The base URL
   * @param string $method      The HTTP method
   * @param string $host        The HTTP host name
   * @param string $scheme      The HTTP scheme
   * @param int    $httpPort    The HTTP port
   * @param int    $httpsPort   The HTTPS port
   * @param string $path        The path
   * @param string $queryString The query string
   */
  public function __construct($baseUrl = '', $method = 'GET', $host = 'localhost', $scheme = 'http', $httpPort = 80, $httpsPort = 443, $path = '/', $queryString = '') {
    $this
      ->setBaseUrl($baseUrl);
    $this
      ->setMethod($method);
    $this
      ->setHost($host);
    $this
      ->setScheme($scheme);
    $this
      ->setHttpPort($httpPort);
    $this
      ->setHttpsPort($httpsPort);
    $this
      ->setPathInfo($path);
    $this
      ->setQueryString($queryString);
  }

  /**
   * Updates the RequestContext information based on a HttpFoundation Request.
   *
   * @param Request $request A Request instance
   *
   * @return RequestContext The current instance, implementing a fluent interface
   */
  public function fromRequest(Request $request) {
    $this
      ->setBaseUrl($request
      ->getBaseUrl());
    $this
      ->setPathInfo($request
      ->getPathInfo());
    $this
      ->setMethod($request
      ->getMethod());
    $this
      ->setHost($request
      ->getHost());
    $this
      ->setScheme($request
      ->getScheme());
    $this
      ->setHttpPort($request
      ->isSecure() ? $this->httpPort : $request
      ->getPort());
    $this
      ->setHttpsPort($request
      ->isSecure() ? $request
      ->getPort() : $this->httpsPort);
    $this
      ->setQueryString($request->server
      ->get('QUERY_STRING', ''));
    return $this;
  }

  /**
   * Gets the base URL.
   *
   * @return string The base URL
   */
  public function getBaseUrl() {
    return $this->baseUrl;
  }

  /**
   * Sets the base URL.
   *
   * @param string $baseUrl The base URL
   *
   * @return RequestContext The current instance, implementing a fluent interface
   */
  public function setBaseUrl($baseUrl) {
    $this->baseUrl = $baseUrl;
    return $this;
  }

  /**
   * Gets the path info.
   *
   * @return string The path info
   */
  public function getPathInfo() {
    return $this->pathInfo;
  }

  /**
   * Sets the path info.
   *
   * @param string $pathInfo The path info
   *
   * @return RequestContext The current instance, implementing a fluent interface
   */
  public function setPathInfo($pathInfo) {
    $this->pathInfo = $pathInfo;
    return $this;
  }

  /**
   * Gets the HTTP method.
   *
   * The method is always an uppercased string.
   *
   * @return string The HTTP method
   */
  public function getMethod() {
    return $this->method;
  }

  /**
   * Sets the HTTP method.
   *
   * @param string $method The HTTP method
   *
   * @return RequestContext The current instance, implementing a fluent interface
   */
  public function setMethod($method) {
    $this->method = strtoupper($method);
    return $this;
  }

  /**
   * Gets the HTTP host.
   *
   * The host is always lowercased because it must be treated case-insensitive.
   *
   * @return string The HTTP host
   */
  public function getHost() {
    return $this->host;
  }

  /**
   * Sets the HTTP host.
   *
   * @param string $host The HTTP host
   *
   * @return RequestContext The current instance, implementing a fluent interface
   */
  public function setHost($host) {
    $this->host = strtolower($host);
    return $this;
  }

  /**
   * Gets the HTTP scheme.
   *
   * @return string The HTTP scheme
   */
  public function getScheme() {
    return $this->scheme;
  }

  /**
   * Sets the HTTP scheme.
   *
   * @param string $scheme The HTTP scheme
   *
   * @return RequestContext The current instance, implementing a fluent interface
   */
  public function setScheme($scheme) {
    $this->scheme = strtolower($scheme);
    return $this;
  }

  /**
   * Gets the HTTP port.
   *
   * @return int The HTTP port
   */
  public function getHttpPort() {
    return $this->httpPort;
  }

  /**
   * Sets the HTTP port.
   *
   * @param int $httpPort The HTTP port
   *
   * @return RequestContext The current instance, implementing a fluent interface
   */
  public function setHttpPort($httpPort) {
    $this->httpPort = (int) $httpPort;
    return $this;
  }

  /**
   * Gets the HTTPS port.
   *
   * @return int The HTTPS port
   */
  public function getHttpsPort() {
    return $this->httpsPort;
  }

  /**
   * Sets the HTTPS port.
   *
   * @param int $httpsPort The HTTPS port
   *
   * @return RequestContext The current instance, implementing a fluent interface
   */
  public function setHttpsPort($httpsPort) {
    $this->httpsPort = (int) $httpsPort;
    return $this;
  }

  /**
   * Gets the query string.
   *
   * @return string The query string without the "?"
   */
  public function getQueryString() {
    return $this->queryString;
  }

  /**
   * Sets the query string.
   *
   * @param string $queryString The query string (after "?")
   *
   * @return RequestContext The current instance, implementing a fluent interface
   */
  public function setQueryString($queryString) {

    // string cast to be fault-tolerant, accepting null
    $this->queryString = (string) $queryString;
    return $this;
  }

  /**
   * Returns the parameters.
   *
   * @return array The parameters
   */
  public function getParameters() {
    return $this->parameters;
  }

  /**
   * Sets the parameters.
   *
   * @param array $parameters The parameters
   *
   * @return RequestContext The current instance, implementing a fluent interface
   */
  public function setParameters(array $parameters) {
    $this->parameters = $parameters;
    return $this;
  }

  /**
   * Gets a parameter value.
   *
   * @param string $name A parameter name
   *
   * @return mixed The parameter value or null if nonexistent
   */
  public function getParameter($name) {
    return isset($this->parameters[$name]) ? $this->parameters[$name] : null;
  }

  /**
   * Checks if a parameter value is set for the given parameter.
   *
   * @param string $name A parameter name
   *
   * @return bool True if the parameter value is set, false otherwise
   */
  public function hasParameter($name) {
    return array_key_exists($name, $this->parameters);
  }

  /**
   * Sets a parameter value.
   *
   * @param string $name      A parameter name
   * @param mixed  $parameter The parameter value
   *
   * @return RequestContext The current instance, implementing a fluent interface
   */
  public function setParameter($name, $parameter) {
    $this->parameters[$name] = $parameter;
    return $this;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
RequestContext::$baseUrl	private	property
RequestContext::$host	private	property
RequestContext::$httpPort	private	property
RequestContext::$httpsPort	private	property
RequestContext::$method	private	property
RequestContext::$parameters	private	property
RequestContext::$pathInfo	private	property
RequestContext::$queryString	private	property
RequestContext::$scheme	private	property
RequestContext::fromRequest	public	function	Updates the RequestContext information based on a HttpFoundation Request.	1
RequestContext::getBaseUrl	public	function	Gets the base URL.
RequestContext::getHost	public	function	Gets the HTTP host.
RequestContext::getHttpPort	public	function	Gets the HTTP port.
RequestContext::getHttpsPort	public	function	Gets the HTTPS port.
RequestContext::getMethod	public	function	Gets the HTTP method.
RequestContext::getParameter	public	function	Gets a parameter value.
RequestContext::getParameters	public	function	Returns the parameters.
RequestContext::getPathInfo	public	function	Gets the path info.
RequestContext::getQueryString	public	function	Gets the query string.
RequestContext::getScheme	public	function	Gets the HTTP scheme.
RequestContext::hasParameter	public	function	Checks if a parameter value is set for the given parameter.
RequestContext::setBaseUrl	public	function	Sets the base URL.
RequestContext::setHost	public	function	Sets the HTTP host.
RequestContext::setHttpPort	public	function	Sets the HTTP port.
RequestContext::setHttpsPort	public	function	Sets the HTTPS port.
RequestContext::setMethod	public	function	Sets the HTTP method.
RequestContext::setParameter	public	function	Sets a parameter value.
RequestContext::setParameters	public	function	Sets the parameters.
RequestContext::setPathInfo	public	function	Sets the path info.
RequestContext::setQueryString	public	function	Sets the query string.
RequestContext::setScheme	public	function	Sets the HTTP scheme.
RequestContext::__construct	public	function	Constructor.