Initial commit

public/kirby/src/Toolkit/Controller.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace Kirby\Toolkit;
+
+use Closure;
+use Kirby\Filesystem\F;
+use ReflectionFunction;
+
+/**
+ * A smart extension of Closures with
+ * magic dependency injection based on the
+ * defined variable names.
+ *
+ * @package   Kirby Toolkit
+ * @author    Bastian Allgeier <bastian@getkirby.com>
+ * @link      https://getkirby.com
+ * @copyright Bastian Allgeier
+ * @license   https://opensource.org/licenses/MIT
+ */
+class Controller
+{
+	public function __construct(protected Closure $function)
+	{
+	}
+
+	public function arguments(array $data = []): array
+	{
+		$info = new ReflectionFunction($this->function);
+		$args = [];
+
+		foreach ($info->getParameters() as $param) {
+			$name = $param->getName();
+
+			if ($param->isVariadic() === true) {
+				// variadic ... argument collects all remaining values
+				$args += $data;
+			} elseif (isset($data[$name]) === true) {
+				// use provided argument value if available
+				$args[$name] = $data[$name];
+			} elseif ($param->isDefaultValueAvailable() === false) {
+				// use null for any other arguments that don't define
+				// a default value for themselves
+				$args[$name] = null;
+			}
+		}
+
+		return $args;
+	}
+
+	public function call($bind = null, $data = [])
+	{
+		// unwrap lazy values in arguments
+		$args = $this->arguments($data);
+		$args = LazyValue::unwrap($args);
+
+		if ($bind === null) {
+			return ($this->function)(...$args);
+		}
+
+		return $this->function->call($bind, ...$args);
+	}
+
+	public static function load(string $file): static|null
+	{
+		if (is_file($file) === false) {
+			return null;
+		}
+
+		$function = F::load($file);
+
+		if ($function instanceof Closure === false) {
+			return null;
+		}
+
+		return new static($function);
+	}
+}