Initial commit

public/kirby/src/Http/Path.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace Kirby\Http;
+
+use Kirby\Toolkit\Collection;
+use Kirby\Toolkit\Str;
+
+/**
+ * A wrapper around an URL path
+ * that converts the path into a Kirby stack
+ *
+ * @package   Kirby Http
+ * @author    Bastian Allgeier <bastian@getkirby.com>
+ * @link      https://getkirby.com
+ * @copyright Bastian Allgeier
+ * @license   https://opensource.org/licenses/MIT
+ */
+class Path extends Collection
+{
+	public function __construct(string|array|null $items)
+	{
+		if (is_string($items) === true) {
+			$items = Str::split($items, '/');
+		}
+
+		parent::__construct($items ?? []);
+	}
+
+	public function __toString(): string
+	{
+		return $this->toString();
+	}
+
+	public function toString(
+		bool $leadingSlash = false,
+		bool $trailingSlash = false
+	): string {
+		if (empty($this->data) === true) {
+			return '';
+		}
+
+		$path = implode('/', $this->data);
+
+		$leadingSlash  = $leadingSlash  === true ? '/' : null;
+		$trailingSlash = $trailingSlash === true ? '/' : null;
+
+		return $leadingSlash . $path . $trailingSlash;
+	}
+}