Add an API for comparing the (current) route name that takes into account deprecated routes

Appears small feedback has been provided by @acbramley.

Wonderif there is a current instance in core that could use this and be converted to show it's worth?

I'm a bit confused by #5 but I might have it backwards.

RouteProvider::getRouteByName() has this:

    $result = reset($routes);
    if ($result instanceof Alias) {
      $alias = $result->getId();
      if ($result->isDeprecated()) {
        $deprecation = $result->getDeprecation($name);
        @trigger_error($deprecation['message'], E_USER_DEPRECATED);
      }
      return $this->getRouteByName($alias);
    }

So... in isRouteName(), if it matches the current rout name, we can assume it's not a deprecated alias because no-one should ever actually land on one and just return TRUE.

If it doesn't match, we can call RouteProvider::getRouteByName() on each of the passed in routes, this will trigger the deprecation we need.

Route preloading should mean this isn't an additional database query. There is some rationalisation to do in #3503843: Remove automatic preloading of all "public" routes, cache routes in fast chained bin but it's just another thing to take into account on that issue.

The Needs Review Queue Bot tested this issue. It no longer applies to Drupal core. Therefore, this issue status is now "Needs work".

This does not mean that the patch necessarily needs to be re-rolled or the MR rebased. Read the Issue Summary, the issue tags and the latest discussion here to determine what needs to be done.

Consult the Drupal Contributor Guide to find step-by-step guides for working with issues.

Now, imagine that those checks happen on every request, wouldn't this mean that we'll be "attaching" the knowledge of those routes to every page in the context of the route preloader?

The route preloader currently loads every non-admin route unconditionally on every request, so it wouldn't make things worse or better, unless we change the behaviour in the issue above, which we might do.

Appears to have merge conflicts

Rebased and fixed tests, marking the MR as ready as it's looking great to me.

Added CR https://www.drupal.org/node/3526518

Applied the MR and searched for \Drupal::routeMatch()->getRouteName() to see if other instances. There were 4 but they weren't doing directly route checking.

All feedback on the MR already appears to be addressed.

Believe good to go

I would be happy to add the handling for deprecated routes but it sounds like there's still some questions on if/where that needs to happen.

#6 would mean we'd need the route provider service in the route match service, right? I'm not sure if this is the right approach but based on #10 it sounds like it might be?

I may be completely off here, but this is what I understood from #6 was right it'd look something like this:

  public function isRouteName(string|array $value, RouteName $operator = RouteName::Equals): bool {
    if (is_array($value) && $operator !== RouteName::In) {
      throw new \InvalidArgumentException('$operator must be RouteName::In when $value is an array.');
    }

    $match = match ($operator) {
      RouteName::Equals => $this->routeName === $value,
      RouteName::StartsWith => str_starts_with($this->routeName, $value),
      RouteName::Contains => str_contains($this->routeName, $value),
      RouteName::EndsWith => str_ends_with($this->routeName, $value),
      RouteName::In => in_array($this->routeName, $value, TRUE),
    };
    // If we have a match, we can assume we aren't on a deprecated route.
    if ($match) {
      return TRUE;
    }
    // Otherwise, get each route by name to trigger deprecations.
    $routeProvider = \Drupal::service('router.route_provider');
    $value = is_array($value) ? $value : [$value];
    foreach ($value as $routeName) {
      $routeProvider->getRouteByName($routeName);
    }

    return FALSE;
  }

When testing this with a debugger, we do call RouteProvider::preLoadRoutes() on every call to getRouteByName which does add a cache get for every unique route that is checked with isRouteName

@acbramley were you testing on a regular page request? RoutePreloader::onRequest() ought to preload all non-admin routes early in the request to avoid separate look-ups.

@catch I was testing on a node edit page, I can double check a non admin page.