PHPackages                             zkrati/router - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. zkrati/router

ActiveLibrary[Utility & Helpers](/categories/utility)

zkrati/router
=============

PHP router as simple as can be

1.0(7y ago)0411MITPHP

Since Aug 8Pushed 7y agoCompare

[ Source](https://github.com/zkrati/router)[ Packagist](https://packagist.org/packages/zkrati/router)[ RSS](/packages/zkrati-router/feed)WikiDiscussions master Synced today

READMEChangelog (9)DependenciesVersions (15)Used By (0)

zkrati/router
=============

[](#zkratirouter)

PHP router as simple as can be...

- simple and fast yet complex routing
- both static and dynamic routes
- supports GET, POST, PUT, DELETE and PATCH requests

### Version

[](#version)

1.0

### Basic usage

[](#basic-usage)

```
$router = new Zkrati\Routing\SimpleRouter();

$router->get("/test", function() {
    // handle GET request at /test
});

$router->post("/test", function() {
    // handle POST request at /test
});

$router->run();
```

simple right?

You can also use other handler declarations

```
$router->get("/test/path", "Class:methodName");
// this code will create an instance of Class and call it's method methodName

$router->get("/test/path", "Namespace\Class:methodName");
// if you are using namespaces
```

If you need to create your own instance for some reason, you can pass the created instance

```
$instance = new Class();
$router->get("/testuju/path", array($instance, "methodName"));
// this code will use the given instance of Class and call it's method methodName
```

### Variables

[](#variables)

You will propably need to map routes with some varibles in it. It was never been easier.

```
$router->get("/test///path", function($variables) {
    // variables  and  are available in array $variables by it's keys
    // for example with url /test/example/showcase/path

    echo $variables["variable"];      // will output "example"
    echo $variables["next_variable"]; // will output "showcase"
});
```

### Parameters

[](#parameters)

If you need to add the parameters to url, you can. It will be passed to your handler as second parameter.

```
$router->get("/test///path", function($variables, $params) {
    // for url /test/example/showcase/path?optional=true&param=john will passed array $params look like:
    // array(2) {
    //     ["optional"] => string(4) "true"
    //     ["param"] => string(4) "john"
    //   }
});
```

### Url wildcards

[](#url-wildcards)

If you are in situation when you are interested only in first half of the path you can use a wildcard.

```
$router->get("/test/path/*", "Class:methodName");
// this code will match all paths starting /test/path/ for example:
//  - /test/path/first
//  - /test/path/second
//  - /test/path/every/other/path
```

You can even use it as a wildcard for all requests, for example:

```
$router->option("*", "Class:methodName");
// This will handle all option requests
```

You can also combine it with variables:

```
$router->get("/test//*", "Class:methodName");
```

### Headers

[](#headers)

Sometimes is useful to know the request headers. You don't need to search it somewhere anymore. Just add third parameter to your handler function.

```
$router->get("/test///path", function($variables, $params, $headers) {
    // variable $headers is array which contains all request headers
});
```

### Exceptions

[](#exceptions)

It is a good idea to wrap route declarations into try catch because in case of invalid handler it will throw InvalidHandlerException

```
try{

    $router->get("/test/", "Class:firstMethod");
    $router->get("/other/route", "Class:secondMethod");
    $router->get("/cool/route", "invalid handler");

} catch(InvalidHandlerException $e) {
    echo $e->getMessage();
}
```

also $router->run(); throws RouteNotFoundException when it founds no route for current url

```
try{
    $router->run();
} catch(RouteNotFoundException $e) {
    echo $e->getMessage();
}
```

### Instances

[](#instances)

If you have custom class in your app which manages instances of all other classes and you want tou use string handler definition you can pass your instantiator into router. The router will get class instances from your custom instantiator.

```
$router->setInstantiator($instantiator, "getInstance");
// where $instantiator is your custom instantiator and "getInstance" is name of it´s method to get instance
```

### Todos

[](#todos)

- define variable types and regexp
- add cache support

License
-------

[](#license)

MIT

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 57.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~58 days

Total

13

Last Release

2911d ago

Major Versions

0.6.1 → 1.02018-07-10

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/20911818?v=4)[zkrati](/maintainers/zkrati)[@zkrati](https://github.com/zkrati)

---

Top Contributors

[![zkrati](https://avatars.githubusercontent.com/u/20911818?v=4)](https://github.com/zkrati "zkrati (4 commits)")[![janliska](https://avatars.githubusercontent.com/u/4991068?v=4)](https://github.com/janliska "janliska (3 commits)")

### Embed Badge

![Health badge](/badges/zkrati-router/health.svg)

```
[![Health](https://phpackages.com/badges/zkrati-router/health.svg)](https://phpackages.com/packages/zkrati-router)
```

###  Alternatives

[cuyz/valinor

Dependency free PHP library that helps to map any input into a strongly-typed structure.

1.5k11.7M155](/packages/cuyz-valinor)[google/cloud-functions-framework

Google Cloud Functions Framework for PHP

21315.0M](/packages/google-cloud-functions-framework)[consolidation/filter-via-dot-access-data

This project uses dflydev/dot-access-data to provide simple output filtering for applications built with annotated-command / Robo.

4649.1M20](/packages/consolidation-filter-via-dot-access-data)[async-aws/async-aws-bundle

Configure all your AsyncAws services and enjoy the autowire greatness.

253.7M4](/packages/async-aws-async-aws-bundle)[barnetik/ticketbai

Generate, sign and submit TicketBAI compatible invoices

416.8k](/packages/barnetik-ticketbai)[sj-i/php-fuse

PHP FFI bindings for FUSE

641.7k2](/packages/sj-i-php-fuse)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)