feat: Query::merge() + Params::merge()

Author: distantnative

src/Http/Params.php

@@ -101,6 +101,23 @@ public function isNotEmpty(): bool
 		return $this->isEmpty() === false;
 	}
 
+	/**
+	 * Merges the current params with the given params
+	 * @since 5.1.0
+	 *
+	 * @return $this
+	 */
+	public function merge(array|string|null $params): static
+	{
+		$params = new static($params);
+
+		foreach ($params as $key => $value) {
+			$this->$key = $value;
+		}
+
+		return $this;
+	}
+
 	/**
 	 * Returns the param separator according
 	 * to the operating system.

src/Http/Query.php

@@ -37,6 +37,23 @@ public function isNotEmpty(): bool
 		return $this->isEmpty() === false;
 	}
 
+	/**
+	 * Merges the current query with the given query
+	 * @since 5.1.0
+	 *
+	 * @return $this
+	 */
+	public function merge(string|array|null $query): static
+	{
+		$query = new static($query);
+
+		foreach ($query as $key => $value) {
+			$this->$key = $value;
+		}
+
+		return $this;
+	}
+
 	public function toString(bool $questionMark = false): string
 	{
 		$query = http_build_query($this, '', '&', PHP_QUERY_RFC3986);

tests/Http/ParamsTest.php

@@ -108,6 +108,15 @@ public function testIsNotEmpty(): void
 		$this->assertFalse($params->isNotEmpty());
 	}
 
+	public function testMerge(): void
+	{
+		$params = new Params(['foo' => 'bar', 'bar' => 'baz']);
+		$params->merge(['bar' => 'foo', 'baz' => 'qux']);
+		$this->assertSame('bar', $params->foo);
+		$this->assertSame('foo', $params->bar);
+		$this->assertSame('qux', $params->baz);
+	}
+
 	public function testToString(): void
 	{
 		$params = new Params([

tests/Http/QueryTest.php

@@ -53,6 +53,15 @@ public function testIsNotEmpty(): void
 		$this->assertFalse($query->isNotEmpty());
 	}
 
+	public function testMerge(): void
+	{
+		$params = new Query(['foo' => 'bar', 'bar' => 'baz']);
+		$params->merge(['bar' => 'foo', 'baz' => 'qux']);
+		$this->assertSame('bar', $params->foo);
+		$this->assertSame('foo', $params->bar);
+		$this->assertSame('qux', $params->baz);
+	}
+
 	public function testToString(): void
 	{
 		$query = new Query([