You are here

public function Request::withUri in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 vendor/guzzlehttp/psr7/src/Request.php \GuzzleHttp\Psr7\Request::withUri()

Returns an instance with the provided URI.

This method MUST update the Host header of the returned request by default if the URI contains a host component. If the URI does not contain a host component, any pre-existing Host header MUST be carried over to the returned request.

You can opt-in to preserving the original state of the Host header by setting `$preserveHost` to `true`. When `$preserveHost` is set to `true`, this method interacts with the Host header in the following ways:

  • If the the Host header is missing or empty, and the new URI contains a host component, this method MUST update the Host header in the returned request.
  • If the Host header is missing or empty, and the new URI does not contain a host component, this method MUST NOT update the Host header in the returned request.
  • If a Host header is present and non-empty, this method MUST NOT update the Host header in the returned request.

This method MUST be implemented in such a way as to retain the immutability of the message, and MUST return an instance that has the new UriInterface instance.

@link http://tools.ietf.org/html/rfc3986#section-4.3

Parameters

UriInterface $uri New request URI to use.:

bool $preserveHost Preserve the original state of the Host header.:

Return value

self

Overrides RequestInterface::withUri

File

vendor/guzzlehttp/psr7/src/Request.php, line 113

Class

Request
PSR-7 request implementation.

Namespace

GuzzleHttp\Psr7

Code

public function withUri(UriInterface $uri, $preserveHost = false) {
  if ($uri === $this->uri) {
    return $this;
  }
  $new = clone $this;
  $new->uri = $uri;
  if (!$preserveHost) {
    if ($host = $uri
      ->getHost()) {
      $new
        ->updateHostFromUri($host);
    }
  }
  return $new;
}