Initial commit

public/kirby/src/Http/Request/Query.php

@@ -0,0 +1,84 @@
+<?php
+
+namespace Kirby\Http\Request;
+
+/**
+ * The Query class helps to
+ * parse and inspect URL queries
+ * as part of the Request object
+ *
+ * @package   Kirby Http
+ * @author    Bastian Allgeier <bastian@getkirby.com>
+ * @link      https://getkirby.com
+ * @copyright Bastian Allgeier
+ * @license   https://opensource.org/licenses/MIT
+ */
+class Query
+{
+	use Data;
+
+	/**
+	 * The Query data array
+	 */
+	protected array|null $data = null;
+
+	/**
+	 * Creates a new Query object.
+	 * The passed data can be an array
+	 * or a parsable query string. If
+	 * null is passed, the current Query
+	 * will be taken from $_GET
+	 */
+	public function __construct(array|string|null $data = null)
+	{
+		if ($data === null) {
+			$this->data = $_GET;
+		} elseif (is_array($data) === true) {
+			$this->data = $data;
+		} else {
+			parse_str($data, $parsed);
+			$this->data = $parsed;
+		}
+	}
+
+	/**
+	 * Returns the Query data as array
+	 */
+	public function data(): array
+	{
+		return $this->data;
+	}
+
+	/**
+	 * Returns `true` if the request doesn't contain query variables
+	 */
+	public function isEmpty(): bool
+	{
+		return empty($this->data) === true;
+	}
+
+	/**
+	 * Returns `true` if the request contains query variables
+	 */
+	public function isNotEmpty(): bool
+	{
+		return empty($this->data) === false;
+	}
+
+	/**
+	 * Converts the query data array
+	 * back to a query string
+	 */
+	public function toString(): string
+	{
+		return http_build_query($this->data());
+	}
+
+	/**
+	 * Magic string converter
+	 */
+	public function __toString(): string
+	{
+		return $this->toString();
+	}
+}