[Routing] Add Requirement, a collection of universal regular-expression constants to use as route parameter requirements

fancyweb · fancyweb · commit 1530a42467c6 · 2022-02-24T10:27:37.000+01:00
diff --git a/src/Symfony/Component/Routing/CHANGELOG.md b/src/Symfony/Component/Routing/CHANGELOG.md
@@ -7,6 +7,7 @@ CHANGELOG
  * Add `getMissingParameters` and `getRouteName` methods on `MissingMandatoryParametersException`
  * Allow using UTF-8 parameter names
  * Support the `attribute` type (alias of `annotation`) in annotation loaders
+ * Add `Requirement`, a collection of universal regular-expression constants to use as route parameter requirements
 
 5.3
 ---
diff --git a/src/Symfony/Component/Routing/Requirement.php b/src/Symfony/Component/Routing/Requirement.php
@@ -0,0 +1,24 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Routing;
+
+/**
+ * A collection of universal regular-expression constants to use as route parameter requirements.
+ */
+final class Requirement
+{
+    public const UID_BASE32 = '[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}';
+    public const UID_BASE58 = '[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}';
+    public const UID_RFC4122 = '[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}';
+    public const ULID = self::UID_BASE32;
+    public const UUID = self::UID_RFC4122;
+}
diff --git a/src/Symfony/Component/Routing/Tests/RequirementTest.php b/src/Symfony/Component/Routing/Tests/RequirementTest.php
@@ -0,0 +1,26 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Routing\Tests;
+
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\Routing\Requirement;
+use Symfony\Component\Routing\Route;
+
+class RequirementTest extends TestCase
+{
+    public function testAllConstantsCompile()
+    {
+        foreach ((new \ReflectionClass(Requirement::class))->getConstants() as $constant) {
+            $this->assertSame(0, preg_match((new Route('/{foo}', [], ['foo' => $constant]))->compile()->getRegex(), '/foo/bar/ccc'));
+        }
+    }
+}
