Add request matcher

Author: joelwurtz

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change Log
 
+## Unreleased
+
+### Added
+
+- Add a request matcher interface and regex implementation
+
 
 ## 1.0.0 - 2016-01-27
 

spec/RequestMatcher/RegexRequestMatcherSpec.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace spec\Http\Message\RequestMatcher;
+
+use Http\Message\RequestMatcher;
+use PhpSpec\ObjectBehavior;
+use Psr\Http\Message\RequestInterface;
+use Psr\Http\Message\UriInterface;
+
+class RegexRequestMatcherSpec extends ObjectBehavior
+{
+    function let($regex)
+    {
+        $this->beConstructedWith($regex);
+    }
+
+    function it_is_a_request_matcher()
+    {
+        $this->shouldImplement('Http\Message\RequestMatcher');
+    }
+
+    function it_is_initializable()
+    {
+        $this->shouldHaveType('Http\Message\RequestMatcher\RegexRequestMatcher');
+    }
+
+    function it_matches(RequestInterface $request, UriInterface $uri)
+    {
+        $this->beConstructedWith('/test/');
+
+        $request->getUri()->willReturn($uri);
+        $uri->__toString()->willReturn('/test');
+
+        $this->matches($request)->shouldReturn(true);
+    }
+
+    function it_does_not_match(RequestInterface $request, UriInterface $uri)
+    {
+        $this->beConstructedWith('/test/');
+
+        $request->getUri()->willReturn($uri);
+        $uri->__toString()->willReturn('/ttttt');
+
+        $this->matches($request)->shouldReturn(false);
+    }
+}

src/RequestMatcher.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace Http\Message;
+
+use Psr\Http\Message\RequestInterface;
+
+/**
+ * Match a request.
+ *
+ * PSR-7 equivalent of Symfony's RequestMatcher
+ *
+ * @see https://github.com/symfony/symfony/blob/master/src/Symfony/Component/HttpFoundation/RequestMatcherInterface.php
+ *
+ * @author Joel Wurtz <[email protected]>
+ */
+interface RequestMatcher
+{
+    /**
+     * Decides whether the rule(s) implemented by the strategy matches the supplied request.
+     *
+     * @param RequestInterface $request The PSR7 request to check for a match
+     *
+     * @return bool true if the request matches, false otherwise
+     */
+    public function matches(RequestInterface $request);
+}

src/RequestMatcher/RegexRequestMatcher.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Http\Message\RequestMatcher;
+
+use Http\Message\RequestMatcher;
+use Psr\Http\Message\RequestInterface;
+
+/**
+ * Match a request with a regex on the uri.
+ *
+ * @author Joel Wurtz <[email protected]>
+ */
+class RegexRequestMatcher implements RequestMatcher
+{
+    /**
+     * Matching regex.
+     *
+     * @var string
+     */
+    private $regex;
+
+    public function __construct($regex)
+    {
+        $this->regex = $regex;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function matches(RequestInterface $request)
+    {
+        return (bool) preg_match($this->regex, (string) $request->getUri());
+    }
+}