RouteList: array access is deprecated

Author: dg

src/Application/Routers/RouteList.php

@@ -94,6 +94,12 @@ public function getModule(): ?string
 	 */
 	public function offsetSet($index, $router): void
 	{
+		if ($router instanceof Route) {
+			trigger_error('Usage `$router[] = new Route(...)` is deprecated, use `$router->addRoute(...)`.', E_USER_DEPRECATED);
+		} else {
+			$class = getclass($router);
+			trigger_error("Usage `\$router[] = new $class` is deprecated, use `\$router->add(new $class)`.", E_USER_DEPRECATED);
+		}
 		if ($index === null) {
 			$this->add($router);
 		} else {
@@ -108,6 +114,7 @@ public function offsetSet($index, $router): void
 	 */
 	public function offsetGet($index): mixed
 	{
+		trigger_error('Usage `$route = $router[...]` is deprecated, use `$router->getRouters()`.', E_USER_DEPRECATED);
 		if (!$this->offsetExists($index)) {
 			throw new Nette\OutOfRangeException('Offset invalid or out of range');
 		}
@@ -120,6 +127,7 @@ public function offsetGet($index): mixed
 	 */
 	public function offsetExists($index): bool
 	{
+		trigger_error('Usage `isset($router[...])` is deprecated.', E_USER_DEPRECATED);
 		return is_int($index) && $index >= 0 && $index < count($this->getRouters());
 	}
 
@@ -130,6 +138,7 @@ public function offsetExists($index): bool
 	 */
 	public function offsetUnset($index): void
 	{
+		trigger_error('Usage `unset($router[$index])` is deprecated, use `$router->modify($index, null)`.', E_USER_DEPRECATED);
 		if (!$this->offsetExists($index)) {
 			throw new Nette\OutOfRangeException('Offset invalid or out of range');
 		}

tests/Bridges.DI/RoutingExtension.basic.phpt

@@ -31,9 +31,10 @@ test('', function () {
 	$container = new Container1;
 	$router = $container->getService('router');
 	Assert::type(Nette\Application\Routers\RouteList::class, $router);
-	Assert::same('index.php', $router[0]->getMask());
-	Assert::same('item/<id>', $router[1]->getMask());
+	$routes = $router->getRouters();
+	Assert::same('index.php', $routes[0]->getMask());
+	Assert::same('item/<id>', $routes[1]->getMask());
 
 	Assert::type(Nette\Application\Routers\RouteList::class, $router);
-	Assert::type(Nette\Application\Routers\Route::class, $router[0]);
+	Assert::type(Nette\Application\Routers\Route::class, $routes[0]);
 });

tests/Routers/RouteList.basic.phpt

@@ -17,7 +17,7 @@ require __DIR__ . '/Route.php';
 
 
 $list = new RouteList;
-$list[] = new Route('<presenter>/<action=default>/<id= \d{1,3}>');
+$list->addRoute('<presenter>/<action=default>/<id= \d{1,3}>');
 
 
 Assert::same('http://example.com/front.homepage/', testRouteOut($list, ['presenter' => 'Front:Homepage']));

tests/Routers/RouteList.modules.phpt

@@ -16,12 +16,12 @@ require __DIR__ . '/Route.php';
 
 
 $list = new RouteList;
-$list[] = new Route('auth/<presenter>[/<action>]', [
+$list->addRoute('auth/<presenter>[/<action>]', [
 	'module' => 'Auth',
 	'presenter' => 'Homepage',
 	'action' => 'default',
 ]);
-$list[] = new Route('<presenter>[/<action>]', [
+$list->addRoute('<presenter>[/<action>]', [
 	'module' => 'Default',
 	'presenter' => 'Homepage',
 	'action' => 'default',