You are here

public function UriInterface::withPath in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 vendor/psr/http-message/src/UriInterface.php \Psr\Http\Message\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

self A new instance with the specified path.

Throws

\InvalidArgumentException for invalid paths.

2 methods override UriInterface::withPath()
Uri::withPath in vendor/zendframework/zend-diactoros/src/Uri.php
Return an instance with the specified path.
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 264

Class

UriInterface
Value object representing a URI.

Namespace

Psr\Http\Message

Code

public function withPath($path);