[9.x] Add "whereIn" route parameter constraint method

src/Illuminate/Routing/CreatesRegularExpressionRouteConstraints.php

@@ -50,6 +50,18 @@ public function whereUuid($parameters)
  return $this->assignExpressionToParameters($parameters, '[\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12}');
  }
 
+ /**
+ * Specify that the given route parameters must be one of the given values.
+ *
+ * @param array|string $parameters
+ * @param array $values
+ * @return $this
+ */
+ public function whereIn($parameters, array $values)
+ {
+ return $this->assignExpressionToParameters($parameters, implode('|', $values));
+ }
+
  /**
  * Apply the given regular expression to the given parameters.
  *

tests/Routing/RouteRegistrarTest.php

@@ -851,6 +851,19 @@ public function testWhereAlphaNumericRegistration()
  }
  }
 
+ public function testWhereInRegistration()
+ {
+ $wheres = ['foo' => 'one|two', 'bar' => 'one|two'];
+
+ $this->router->get('/{foo}/{bar}')->whereIn(['foo', 'bar'], ['one', 'two']);
+ $this->router->get('/api/{bar}/{foo}')->whereIn(['bar', 'foo'], ['one', 'two']);
+
+ /** @var \Illuminate\Routing\Route $route */
+ foreach ($this->router->getRoutes() as $route) {
+ $this->assertEquals($wheres, $route->wheres);
+ }
+ }
+
  public function testCanSetRouteName()
  {
  $this->router->as('users.index')->get('users', function () {

tests/Routing/RoutingRouteTest.php

@@ -800,6 +800,20 @@ public function testWherePatternsProperlyFilter()
  $route->where('bar', '[0-9]+');
  $this->assertFalse($route->matches($request));
 
+ $request = Request::create('foo/123', 'GET');
+ $route = new Route('GET', 'foo/{bar}', ['where' => ['bar' => '123|456'], function () {
+ //
+ }]);
+ $route->where('bar', '123|456');
+ $this->assertTrue($route->matches($request));
+
+ $request = Request::create('foo/123abc', 'GET');
+ $route = new Route('GET', 'foo/{bar}', ['where' => ['bar' => '123|456'], function () {
+ //
+ }]);
+ $route->where('bar', '123|456');
+ $this->assertFalse($route->matches($request));
+
  /*
  * Optional
  */