Download the PHP package crodas/dispatcher without Composer

Dispatcher

Dispatcher is a routing library that maps URLs to actions.

Installing

You can install using composer:

Defining routes

Routes are defined using annotations for methods or functions.

Dispatcher walks over the filesystem looking for @Route annotations on functions and methods.

How to use it

By default, it runs in production mode and it won't rebuild the routes on changes. If you wish to run on development mode, you should do this:

Filters

To simply things, Dispatcher doesn't allow you yet to define regular expressions to validate your placeholders. Instead it lets you to define functions which validates and modified the values of your placeholders.

The filter should return a false if $value is not valid the router will jump to the next rule or will throw a notfound exception. $name is used because one callback can be used as multiple filters.

Expensive Filters can be cached with @Cache <ttl> annotation. The cache mechanism is defined in the application with a class which implements FilterCache interface.

Valid Patterns

• /foo/bar
• /foo/{user}
• /foo/{user:user1}/{user:user2}: Inside the Request object the user objects will be named user1 and user2 to avoid name collisions.
• /foo/{user:u1}-vs-{user:u2}.{ext}: We can have multiple variables inside one single directory level as long as they are separated by constants.