perritu / router

v3.0.0 2026-10-01 10:32 UTC

Requires

• php: >=8.5

Unlicense

• Angel Garcia

Published on Packagist.org on 2026-10-01 10:36 UTC

README

A lightweight, simple, yet blazing fast PHP router.

Features

• Supports for DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT, and QUERY request methods.
• Routing shortcuts.
  • Router::DELETE(), Router::GET(), Router::HEAD(), etc.
• Static and dynamic PCRE-based routing.
• Custom Path and/or HTTP-Method call override.
• Use of Path\to\public::method callback.
• Subrouting / route prefixes.
• Subnamespace / namespace prefixes.
• Namespace mapping.

Requirements

Perritu/Router can run just fine out-of-the-box. All what is needed is PHP 8.5 or greater and any URL rewriting technique.

Installation.

• Using composer. (Recomended)
  • composer require perritu/router
• Direct download.
  • Downlad and place the Router.php file outside your publicly accessible directory, so any call must be performed throug your code flow.
  • Do a require_once import from your code flow.

  require_once(PROJECT_ROOT .'/include/perritu/router.php');

Usage

Once imported, do a use statement to start using the router, then, start with your routing definitions.

Bare example:

// Require statement
require_once('../vendor/autoload.php'); // Or router.php if not using composer.

use Perritu\Router\Router;

// Router definition
Router::GET('/', function() { echo 'Hello World!'; });

You can read the documentation in the DOCS.

External links.

Codacy: https://app.codacy.com/gh/Perritu/Router/dashboard

Packagist: https://packagist.org/packages/perritu/router

FOSSA: https://app.fossa.com/projects/git%2Bgithub.com%2FPerritu%2FRouter?ref=readme