class PathMatcherTest

Same name in other branches
  1. 9 core/tests/Drupal/Tests/Core/Path/PathMatcherTest.php \Drupal\Tests\Core\Path\PathMatcherTest
  2. 8.9.x core/tests/Drupal/Tests/Core/Path/PathMatcherTest.php \Drupal\Tests\Core\Path\PathMatcherTest
  3. 11.x core/tests/Drupal/Tests/Core/Path/PathMatcherTest.php \Drupal\Tests\Core\Path\PathMatcherTest

@coversDefaultClass \Drupal\Core\Path\PathMatcher @group Path

Hierarchy

Expanded class hierarchy of PathMatcherTest

File

core/tests/Drupal/Tests/Core/Path/PathMatcherTest.php, line 14

Namespace

Drupal\Tests\Core\Path
View source 
class PathMatcherTest extends UnitTestCase {
    
    /**
     * The path matcher under test.
     *
     * @var \Drupal\Core\Path\PathMatcher
     */
    protected $pathMatcher;
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        parent::setUp();
        // Create a stub config factory with all config settings that will be
        // checked during this test.
        $config_factory_stub = $this->getConfigFactoryStub([
            'system.site' => [
                'page.front' => '/dummy',
            ],
        ]);
        $route_match = $this->createMock('Drupal\\Core\\Routing\\RouteMatchInterface');
        $this->pathMatcher = new PathMatcher($config_factory_stub, $route_match);
    }
    
    /**
     * Tests that standard paths works with multiple patterns.
     *
     * @dataProvider getMatchPathData
     */
    public function testMatchPath($patterns, $paths) : void {
        foreach ($paths as $path => $expected_result) {
            $actual_result = $this->pathMatcher
                ->matchPath($path, $patterns);
            $this->assertEquals($actual_result, $expected_result, "Tried matching the path '{$path}' to the pattern '{$patterns}'.");
        }
    }
    
    /**
     * Provides test path data.
     *
     * @return array
     *   A nested array of pattern arrays and path arrays.
     */
    public static function getMatchPathData() {
        return [
            [
                // Single absolute paths.
'/example/1',
                [
                    '/example/1' => TRUE,
                    '/example/2' => FALSE,
                    '/test' => FALSE,
                ],
            ],
            [
                // Single paths with wildcards.
'/example/*',
                [
                    '/example/1' => TRUE,
                    '/example/2' => TRUE,
                    '/example/3/edit' => TRUE,
                    '/example/' => TRUE,
                    '/example' => FALSE,
                    '/test' => FALSE,
                ],
            ],
            [
                // Single paths with multiple wildcards.
'/node/*/revisions/*',
                [
                    '/node/1/revisions/3' => TRUE,
                    '/node/345/revisions/test' => TRUE,
                    '/node/23/edit' => FALSE,
                    '/test' => FALSE,
                ],
            ],
            [
                // Single paths with '<front>'.
"<front>",
                [
                    '/dummy' => TRUE,
                    "/dummy/" => FALSE,
                    "/dummy/edit" => FALSE,
                    '/node' => FALSE,
                    '' => FALSE,
                ],
            ],
            [
                // Paths with both '<front>' and wildcards (should not work).
"<front>/*",
                [
                    '/dummy' => FALSE,
                    '/dummy/' => FALSE,
                    '/dummy/edit' => FALSE,
                    '/node/12' => FALSE,
                    '/' => FALSE,
                ],
            ],
            [
                // Multiple paths with the \n delimiter.
"/node/*\n/node/*/edit",
                [
                    '/node/1' => TRUE,
                    '/node/view' => TRUE,
                    '/node/32/edit' => TRUE,
                    '/node/delete/edit' => TRUE,
                    '/node/50/delete' => TRUE,
                    '/test/example' => FALSE,
                ],
            ],
            [
                // Multiple paths with the \r delimiter.
"/user/*\r/example/*",
                [
                    '/user/1' => TRUE,
                    '/example/1' => TRUE,
                    '/user/1/example/1' => TRUE,
                    '/user/example' => TRUE,
                    '/test/example' => FALSE,
                    '/user' => FALSE,
                    '/example' => FALSE,
                ],
            ],
            [
                // Multiple paths with the \r\n delimiter.
"/test\r\n<front>",
                [
                    '/test' => TRUE,
                    '/dummy' => TRUE,
                    '/example' => FALSE,
                ],
            ],
            [
                // Test existing regular expressions (should be escaped).
'[^/]+?/[0-9]',
                [
                    '/test/1' => FALSE,
                    '[^/]+?/[0-9]' => TRUE,
                ],
            ],
        ];
    }

}

Members

Title Deprecated Modifiers Object type Summary Overriden Title Overrides
PathMatcherTest::$pathMatcher protected property The path matcher under test.
PathMatcherTest::getMatchPathData public static function Provides test path data.
PathMatcherTest::setUp protected function Overrides UnitTestCase::setUp
PathMatcherTest::testMatchPath public function Tests that standard paths works with multiple patterns.
PhpUnitWarnings::$deprecationWarnings private static property Deprecation warnings from PHPUnit to raise with @trigger_error().
PhpUnitWarnings::addWarning public function Converts PHPUnit deprecation warnings to E_USER_DEPRECATED.
RandomGeneratorTrait::getRandomGenerator protected function Gets the random generator for the utility methods.
RandomGeneratorTrait::randomMachineName protected function Generates a unique random string containing letters and numbers.
RandomGeneratorTrait::randomObject public function Generates a random PHP object.
RandomGeneratorTrait::randomString public function Generates a pseudo-random string of ASCII characters of codes 32 to 126.
RandomGeneratorTrait::randomStringValidate Deprecated public function Callback for random string validation.
UnitTestCase::$root protected property The app root. 1
UnitTestCase::getClassResolverStub protected function Returns a stub class resolver.
UnitTestCase::getConfigFactoryStub public function Returns a stub config factory that behaves according to the passed array.
UnitTestCase::getConfigStorageStub public function Returns a stub config storage that returns the supplied configuration.
UnitTestCase::getContainerWithCacheTagsInvalidator protected function Sets up a container with a cache tags invalidator.
UnitTestCase::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::setUpBeforeClass public static function
UnitTestCase::__get public function

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.