function UriInterface::withPath

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.

1 method overrides UriInterface::withPath()

Uri::withPath in vendor/guzzlehttp/psr7/src/Uri.php

Return an instance with the specified path.

File

vendor/psr/http-message/src/UriInterface.php, line 265

Class

UriInterface

Value object representing a URI.

Namespace

Psr\Http\Message

Code

public function withPath(string $path) : UriInterface;