annotate core/lib/Drupal/Core/Routing/ResettableStackedRouteMatchInterface.php @ 13:5fb285c0d0e3

Update Drupal core to 8.4.7 via Composer. Security update; I *think* we've
been lucky to get away with this so far, as we don't support self-registration
which seems to be used by the so-called "drupalgeddon 2" attack that 8.4.5
was vulnerable to.

<?php

namespace Drupal\Core\Routing;

/**
 * Defines an interface for a resettable stack of route matches.
 *
 * @todo Move this method to \Drupal\Core\Routing\StackedRouteMatchInterface in
 *   https://www.drupal.org/node/2659952.
 */
interface ResettableStackedRouteMatchInterface extends StackedRouteMatchInterface {

  /**
   * Resets the route match static cache.
   *
   * The route match should only be statically cached once routing is finished.
   * Any code that uses a route match during routing may be incorrectly assumed
   * to be acting after routing has completed. This method gives that code the
   * ability to fix the static cache.
   */
  public function resetRouteMatch();

}