You are here

public function Uri::withPath in Lockr 7.3

Return an instance with the specified path.

This method MUST retain the state of the current instance, and return an instance that contains the specified path.

The path can either be empty or absolute (starting with a slash) or rootless (not starting with a slash). Implementations MUST support all three syntaxes.

If the path is intended to be domain-relative rather than path relative then it must begin with a slash ("/"). Paths not starting with a slash ("/") are assumed to be relative to some base path known to the application or consumer.

Users can provide both encoded and decoded path characters. Implementations ensure the correct encoding as outlined in getPath().

Parameters

string $path The path to use with the new instance.:

Return value

static A new instance with the specified path.

Throws

\InvalidArgumentException for invalid paths.

Overrides UriInterface::withPath

File

vendor/guzzlehttp/psr7/src/Uri.php, line 487

Class

Uri
PSR-7 URI implementation.

Namespace

GuzzleHttp\Psr7

Code

public function withPath($path) {
  $path = $this
    ->filterPath($path);
  if ($this->path === $path) {
    return $this;
  }
  $new = clone $this;
  $new->path = $path;
  $new
    ->validateState();
  return $new;
}