weew/url-matcher

Simple url matcher and parser.

Url matcher

, _(*1)

Table of contents

• Installation
• Introduction
• Usage
• Matching
• Parsing
• Replacing

Installation

composer require weew/url-matcher, _(*2)

Introduction

This this simple matcher allows you to match url like paths against patterns with placeholders and even extract them., _(*3)

Usage

Creating a new matcher is very simple., _(*4)

$matcher = new UrlMatcher();

Matching

Below is a very basic matching example., _(*5)

// true
$matcher->match('users/{id}', 'users/1');

// false
$matcher->match('users/{id}', 'users');

Placeholders can be optional by adding ? at the end., _(*6)

// true
$matcher->match('users/{id?}', 'users/1');

// true
$matcher->match('users/{id?}', 'users');

Placeholders can have custom patterns., _(*7)

$matcher->addPattern('id', '[0-9]+');

// true
$matcher->match('users/{id}', 'users/1');

// false
$matcher->match('users/{id}', 'users/abc');

You can provide patterns inline., _(*8)

// true
$matcher->match('users/{id}', 'users/1', [
    'id' => '[0-9]+',
]);

Placeholders can be optional too., _(*9)

// true
$matcher->match('users/{id?}', 'users/1', [
    'id' => '[0-9]+',
]);

// true
$matcher->match('users/{id?}', 'users', [
    'id' => '[0-9]+',
]);

Parsing

Extracting placeholders is very trivial too. The parse method always returns an instance of IDictionary., _(*10)

$dictionary = $matcher->parse('users/{id}', 'users/123');
// 123
$dictionary->get('id');

$dictionary = $matcher->parse('users/{id}', 'users');
// null
$dictionary->get('id');

Of course, placeholders can have custom patterns., _(*11)

$matcher->addPattern('id', '[0-9]+');
$dictionary = $matcher->parse('users/{id}', 'users/123');
// 123
$dictionary->get('id');

$dictionary = $matcher->parse('users/{id}', 'users/abc');
// null
$dictionary->get('id');

Replacing

You can do the opposite of parsing by replacing placeholders with specific values., _(*12)

// api.service.com
$matcher->replace('{subdomain}.service.com', 'subdomain', 'api');

// api.service.com/v1
$matcher->replaceAll('{subdomain}.service.com/{version}', ['subdomain' => 'api', 'version' => 'v1']);