added feature "link aliases"

Author: dg

src/Application/LinkGenerator.php

@@ -9,6 +9,7 @@
 
 namespace Nette\Application;
 
+use Nette;
 use Nette\Http\UrlScript;
 use Nette\Routing\Router;
 
@@ -33,11 +34,18 @@ public function __construct(
 	 */
 	public function link(string $dest, array $params = []): string
 	{
-		if (!preg_match('~^([\w:]+):(\w*+)(#.*)?()$~D', $dest, $m)) {
+		if (!preg_match('~^(@[\w:-]++|[\w:]+:\w*+)(#.*)?()$~D', $dest, $m)) {
 			throw new UI\InvalidLinkException("Invalid link destination '$dest'.");
 		}
 
-		[, $presenter, $action, $frag] = $m;
+		[, $path, $frag] = $m;
+		if ($path[0] === '@') {
+			if (!$this->presenterFactory instanceof PresenterFactory) {
+				throw new Nette\InvalidStateException('Link aliasing requires PresenterFactory service.');
+			}
+			$path = $this->presenterFactory->getAlias(substr($path, 1));
+		}
+		[$presenter, $action] = Helpers::splitName($path);
 
 		try {
 			$class = $this->presenterFactory?->getPresenterClass($presenter);

src/Application/PresenterFactory.php

@@ -23,6 +23,7 @@ class PresenterFactory implements IPresenterFactory
 		'Nette' => ['NetteModule\\', '*\\', '*Presenter'],
 	];
 
+	private array $aliases = [];
 	private array $cache = [];
 
 	/** @var callable */
@@ -117,4 +118,20 @@ public function formatPresenterClass(string $presenter): string
 
 		return $mapping[0];
 	}
+
+
+	/**
+	 * Sets pairs [alias => destination]
+	 */
+	public function setAliases(array $aliases): static
+	{
+		$this->aliases = $aliases;
+		return $this;
+	}
+
+
+	public function getAlias(string $alias): string
+	{
+		return $this->aliases[$alias] ?? throw new Nette\InvalidStateException("Link alias '$alias' was not found.");
+	}
 }

src/Application/UI/Presenter.php

@@ -856,6 +856,13 @@ protected function createRequest(
 			$path = 'this';
 		}
 
+		if ($path[0] === '@') {
+			if (!($this->presenterFactory ?? null) instanceof Application\PresenterFactory) {
+				throw new Nette\InvalidStateException('Link aliasing requires PresenterFactory service.');
+			}
+			$path = ':' . $this->presenterFactory->getAlias(substr($path, 1));
+		}
+
 		$current = false;
 		[$presenter, $action] = Helpers::splitName($path);
 		if ($presenter === '') {

src/Bridges/ApplicationDI/ApplicationExtension.php

@@ -52,6 +52,7 @@ public function getConfigSchema(): Nette\Schema\Schema
 				Expect::string(),
 				Expect::arrayOf('string|array'),
 			),
+			'aliases' => Expect::arrayOf('string'),
 			'scanDirs' => Expect::anyOf(
 				Expect::arrayOf('string')->default($this->scanDirs)->mergeDefaults(),
 				false,
@@ -101,6 +102,10 @@ public function loadConfiguration(): void
 			]);
 		}
 
+		if ($config->aliases) {
+			$presenterFactory->addSetup('setAliases', [$config->aliases]);
+		}
+
 		$builder->addDefinition($this->prefix('linkGenerator'))
 			->setFactory(Nette\Application\LinkGenerator::class, [
 				1 => new Definitions\Statement([new Definitions\Statement('@Nette\Http\IRequest::getUrl'), 'withoutUserInfo']),

tests/Routers/link-aliases.phpt

@@ -0,0 +1,58 @@
+<?php
+
+/**
+ * Test: Nette\Application\UI\Component::redirect()
+ */
+
+declare(strict_types=1);
+
+use Nette\Application;
+use Nette\Application\PresenterFactory;
+use Nette\Http;
+use Tester\Assert;
+
+require __DIR__ . '/../bootstrap.php';
+
+
+class TestPresenter extends Application\UI\Presenter
+{
+}
+
+
+$factory = new PresenterFactory;
+$factory->setAliases([
+	'a' => 'Test:a',
+	'b' => 'Test:b',
+]);
+
+Assert::same('Test:a', $factory->getAlias('a'));
+Assert::same('Test:b', $factory->getAlias('b'));
+Assert::exception(
+	fn() => $factory->getAlias('c'),
+	Nette\InvalidStateException::class,
+	"Link alias 'c' was not found.",
+);
+
+
+
+// link generator
+$generator = new Application\LinkGenerator(
+	new Application\Routers\SimpleRouter,
+	new Http\UrlScript('http://localhost'),
+	$factory,
+);
+
+Assert::same('http://localhost/?action=a&presenter=Test', $generator->link('@a'));
+
+
+// presenter
+$presenter = new TestPresenter;
+$presenter->injectPrimary(
+	new Http\Request(new Http\UrlScript('http://localhost')),
+	new Http\Response,
+	$factory,
+	new Application\Routers\SimpleRouter,
+);
+
+
+Assert::same('/?action=a&presenter=Test', $presenter->link('@a'));