UrlImmutable: added with***() methods

Author: dg

src/Http/UrlImmutable.php

@@ -87,24 +87,72 @@ public function __construct($url)
 	}
 
 
+	/**
+	 * @return static
+	 */
+	public function withScheme(string $scheme)
+	{
+		$dolly = clone $this;
+		$dolly->scheme = $scheme;
+		$dolly->build();
+		return $dolly;
+	}
+
+
 	public function getScheme(): string
 	{
 		return $this->scheme;
 	}
 
 
+	/**
+	 * @return static
+	 */
+	public function withUser(string $user)
+	{
+		$dolly = clone $this;
+		$dolly->user = $user;
+		$dolly->build();
+		return $dolly;
+	}
+
+
 	public function getUser(): string
 	{
 		return $this->user;
 	}
 
 
+	/**
+	 * @return static
+	 */
+	public function withPassword(string $password)
+	{
+		$dolly = clone $this;
+		$dolly->password = $password;
+		$dolly->build();
+		return $dolly;
+	}
+
+
 	public function getPassword(): string
 	{
 		return $this->password;
 	}
 
 
+	/**
+	 * @return static
+	 */
+	public function withHost(string $host)
+	{
+		$dolly = clone $this;
+		$dolly->host = $host;
+		$dolly->build();
+		return $dolly;
+	}
+
+
 	public function getHost(): string
 	{
 		return $this->host;
@@ -119,18 +167,55 @@ public function getDomain(int $level = 2): string
 	}
 
 
+	/**
+	 * @return static
+	 */
+	public function withPort(int $port)
+	{
+		$dolly = clone $this;
+		$dolly->port = $port;
+		$dolly->build();
+		return $dolly;
+	}
+
+
 	public function getPort(): ?int
 	{
 		return $this->port ?: (Url::$defaultPorts[$this->scheme] ?? null);
 	}
 
 
+	/**
+	 * @return static
+	 */
+	public function withPath(string $path)
+	{
+		$dolly = clone $this;
+		$dolly->path = $path;
+		$dolly->build();
+		return $dolly;
+	}
+
+
 	public function getPath(): string
 	{
 		return $this->path;
 	}
 
 
+	/**
+	 * @param  string|array  $query
+	 * @return static
+	 */
+	public function withQuery($query)
+	{
+		$dolly = clone $this;
+		$dolly->query = is_array($query) ? $query : Url::parseQuery($query);
+		$dolly->build();
+		return $dolly;
+	}
+
+
 	public function getQuery(): string
 	{
 		return http_build_query($this->query, '', '&', PHP_QUERY_RFC3986);
@@ -152,6 +237,18 @@ public function getQueryParameter(string $name)
 	}
 
 
+	/**
+	 * @return static
+	 */
+	public function withFragment(string $fragment)
+	{
+		$dolly = clone $this;
+		$dolly->fragment = $fragment;
+		$dolly->build();
+		return $dolly;
+	}
+
+
 	public function getFragment(): string
 	{
 		return $this->fragment;

tests/Http/UrlImmutable.manipulation.phpt

@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+use Nette\Http\UrlImmutable;
+use Tester\Assert;
+
+
+require __DIR__ . '/../bootstrap.php';
+
+
+test(function () {
+	$url = new UrlImmutable('http://username%3A:password%3A@hostn%61me:60/p%61th/script.php?%61rg=value#%61nchor');
+
+	$url = $url->withScheme('');
+	Assert::same('//username%3A:password%3A@hostname:60/p%61th/script.php?arg=value#anchor', $url->absoluteUrl);
+
+	$url = $url->withUser('name');
+	Assert::same('//name:password%3A@hostname:60/p%61th/script.php?arg=value#anchor', $url->absoluteUrl);
+
+	$url = $url->withPassword('secret');
+	Assert::same('//name:secret@hostname:60/p%61th/script.php?arg=value#anchor', $url->absoluteUrl);
+
+	$url = $url->withHost('localhost');
+	Assert::same('//name:secret@localhost:60/p%61th/script.php?arg=value#anchor', $url->absoluteUrl);
+
+	$url = $url->withPort(123);
+	Assert::same('//name:secret@localhost:123/p%61th/script.php?arg=value#anchor', $url->absoluteUrl);
+
+	$url = $url->withFragment('hello');
+	Assert::same('//name:secret@localhost:123/p%61th/script.php?arg=value#hello', $url->absoluteUrl);
+});
+
+
+test(function () {
+	$url = new UrlImmutable('http://username%3A:password%3A@hostn%61me:60/p%61th/script.php?%61rg=value#%61nchor');
+
+	$url = $url->withPath('');
+	Assert::same('/', $url->getPath());
+
+	$url = $url->withPath('/');
+	Assert::same('/', $url->getPath());
+
+	$url = $url->withPath('x');
+	Assert::same('/x', $url->getPath());
+
+	$url = $url->withPath('/x');
+	Assert::same('/x', $url->getPath());
+
+	$url = $url->withPath('');
+	Assert::same('/', $url->getPath());
+
+	$url = $url->withHost('')->withPath('');
+	Assert::same('http://?arg=value#anchor', $url->absoluteUrl);
+
+	$url = $url->withPath('');
+	Assert::same('', $url->getPath());
+});
+
+
+test(function () {
+	$url = new UrlImmutable('http://hostname/path?arg=value');
+	Assert::same('arg=value', $url->query);
+
+	$url = $url->withQuery(['arg3' => 'value3']);
+	Assert::same('arg3=value3', $url->query);
+
+	$url = $url->withQuery([null]);
+	Assert::same('http://hostname/path', $url->getAbsoluteUrl());
+});