[Routing] Added an optional event trigger for handleRouteRequirements

src/Symfony/Component/Routing/Matcher/UrlMatcher.php

@@ -16,6 +16,8 @@
 use Symfony\Component\Routing\RouteCollection;
 use Symfony\Component\Routing\RequestContext;
 use Symfony\Component\Routing\Route;
+use Symfony\Component\EventDispatcher\EventDispatcher;
+use Symfony\Component\EventDispatcher\Event;
 
 /**
  * UrlMatcher matches URL based on a set of routes.
@@ -30,9 +32,13 @@ class UrlMatcher implements UrlMatcherInterface
     const REQUIREMENT_MISMATCH  = 1;
     const ROUTE_MATCH           = 2;
 
+    const EVENT_HANDLE_REQUIREMENTS = 'routing.match.requirements';
+
     protected $context;
     protected $allow;
 
+    protected $dispatcher;
+
     private $routes;
 
     /**
@@ -65,6 +71,14 @@ public function getContext()
         return $this->context;
     }
 
+    /**
+     * @param \Symfony\Component\EventDispatcher\EventDispatcher $event_dispatcher
+     */
+    public function setEventDispatcher(EventDispatcher $event_dispatcher)
+    {
+        $this->dispatcher = $event_dispatcher;
+    }
+
     /**
      * {@inheritdoc}
      */
@@ -161,6 +175,16 @@ protected function handleRouteRequirements($pathinfo, $name, Route $route)
         $scheme = $route->getRequirement('_scheme');
         $status = $scheme && $scheme !== $this->context->getScheme() ? self::REQUIREMENT_MISMATCH : self::REQUIREMENT_MATCH;
 
+        if (0 === $status) {
+            return array($status, null);
+        }
+
+        if ($this->dispatcher) {
+            $event = new UrlMatcherEvent($route);
+            $this->dispatcher->dispatch(self::EVENT_HANDLE_REQUIREMENTS, $event);
+            $status = $event->getStatus();
+        }
+
         return array($status, null);
     }
 

src/Symfony/Component/Routing/Matcher/UrlMatcherEvent.php

@@ -0,0 +1,61 @@
+<?php
+
+namespace Symfony\Component\Routing\Matcher;
+
+use Symfony\Component\EventDispatcher\Event;
+use Symfony\Component\Routing\Route;
+
+class UrlMatcherEvent extends Event
+{
+    private $route;
+
+    private $status;
+
+    const REQUIREMENT_MISMATCH = 2;
+    const REQUIREMENT_MATCH = 1;
+
+    public function __construct(Route $route)
+    {
+        $this->route = $route;
+    }
+
+    /**
+     * Returns the route being matched
+     *
+     * @return \Symfony\Component\Routing\Route
+     */
+    public function getRoute()
+    {
+        return $this->route;
+    }
+
+    /**
+     * Set the result of the requirement match
+     *
+     * 0 - Mismatch
+     * 1 - Match
+     * null - No vote
+     *
+     * First listener to set to Mismatch wins
+     *
+     * @param $status boolean|null
+     */
+    public function setStatus($status)
+    {
+        $this->status = $status;
+
+        if ($this->status == self::REQUIREMENT_MISMATCH) {
+            $this->stopPropagation();
+        }
+    }
+
+    /**
+     * Returns the set status
+     *
+     * @return boolean|null
+     */
+    public function getStatus()
+    {
+        return $this->status;
+    }
+}