public function Request::withRequestTarget in Zircon Profile 8

Same name and namespace in other branches

1. 8.0 vendor/guzzlehttp/psr7/src/Request.php \GuzzleHttp\Psr7\Request::withRequestTarget()

Return an instance with the specific request-target.

If the request needs a non-origin-form request-target — e.g., for specifying an absolute-form, authority-form, or asterisk-form — this method may be used to create an instance with the specified request-target, verbatim.

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 changed request target.

@link http://tools.ietf.org/html/rfc7230#section-2.7 (for the various request-target forms allowed in request messages)

Parameters

mixed $requestTarget:

Return value

self

Overrides RequestInterface::withRequestTarget

File

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

Class

Request

PSR-7 request implementation.

Namespace

GuzzleHttp\Psr7

Code

public function withRequestTarget($requestTarget) {
  if (preg_match('#\\s#', $requestTarget)) {
    throw new InvalidArgumentException('Invalid request target provided; cannot contain whitespace');
  }
  $new = clone $this;
  $new->requestTarget = $requestTarget;
  return $new;
}