Download the PHP package stefanobalocco/damnsmallrouter without Composer

DamnSmallRouter

A really simple and small pathinfo php router

Installation

Install via Composer:

Or add to composer.json:

Run composer install or composer update.

Basic Usage

Initialization

Adding Routes

Error Handling

Default error routes set HTTP response codes and return null. Customize them:

Router Execution

Key Features

• Pattern matching with placeholder support
• Support for multiple HTTP methods
• Customizable error handling with automatic status codes
• Automatic HEAD request handling (converted to GET)

Available Placeholders

• #09#: Numbers (\d+)
• #AZ#: Letters ([a-zA-Z]+)
• #AZ09#: Alphanumeric characters ([\w]+)

Methods

AddRoute($route, $callback, $variables = [], $method = 'GET', $available = null)

Adds a new route with:

• $route: URL pattern with placeholders
• $callback: Function to execute (receives $variables first, then pattern matches)
• $variables: Additional variables passed as first parameters to callback
• $method: HTTP method (GET, POST, PUT, DELETE, etc.)
• $available: Boolean condition for route availability

RouteAvailable($method = 'GET', $withoutConditions = false)

Checks if a route is available for the current path.

• $method: HTTP method to check
• $withoutConditions: If true, ignores the $available parameter of routes

Route()

Executes routing for the current request and returns the callback result.

Error Route Methods

• AddRoute403($callback, $variables = []): Sets handler for forbidden access
• AddRoute404($callback, $variables = []): Sets handler for not found
• AddRoute405($callback, $variables = []): Sets handler for method not allowed
• AddRoute500($callback, $variables = []): Sets handler for internal server errors