function Uri::withQueryValue

Creates a new URI with a specific query string value.

Any existing query string values that exactly match the provided key are removed and replaced with the given key value pair.

A value of null will set the query string key without a value, e.g. "key" instead of "key=value".

Parameters

UriInterface $uri URI to use as a base.:

string $key Key to set.:

string|null $value Value to set:

File

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

Class

Uri

PSR-7 URI implementation.

Namespace

GuzzleHttp\Psr7

Code

public static function withQueryValue(UriInterface $uri, string $key, ?string $value) : UriInterface {
    $result = self::getFilteredQueryString($uri, [
        $key,
    ]);
    $result[] = self::generateQueryString($key, $value);
    return $uri->withQuery(implode('&', $result));
}