julienmonnerie/kirby/src/Toolkit/Controller.php

<?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);
	}
}