{"id":19143795,"url":"https://github.com/teodoroleckie/router","last_synced_at":"2026-06-11T04:30:19.585Z","repository":{"id":57070539,"uuid":"359811393","full_name":"teodoroleckie/router","owner":"teodoroleckie","description":"⚡ Simple and fast router PSR-7, PSR-17, PSR-15","archived":false,"fork":false,"pushed_at":"2021-05-13T08:48:46.000Z","size":61,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-03T15:45:41.862Z","etag":null,"topics":["php","php8","psr-15","psr-17","psr-7","routed","router","routes","routing"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/teodoroleckie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":["teodoroleckie"],"custom":["https://www.paypal.com/donate?business=ZHYA2MTGA4884\u0026currency_code=USD"]}},"created_at":"2021-04-20T12:41:04.000Z","updated_at":"2021-05-13T08:48:48.000Z","dependencies_parsed_at":"2022-08-24T14:54:22.937Z","dependency_job_id":null,"html_url":"https://github.com/teodoroleckie/router","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teodoroleckie%2Frouter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teodoroleckie%2Frouter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teodoroleckie%2Frouter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teodoroleckie%2Frouter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/teodoroleckie","download_url":"https://codeload.github.com/teodoroleckie/router/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240224794,"owners_count":19767808,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["php","php8","psr-15","psr-17","psr-7","routed","router","routes","routing"],"created_at":"2024-11-09T07:32:51.222Z","updated_at":"2026-06-11T04:30:19.430Z","avatar_url":"https://github.com/teodoroleckie.png","language":"PHP","funding_links":["https://github.com/sponsors/teodoroleckie","https://www.paypal.com/donate?business=ZHYA2MTGA4884\u0026currency_code=USD"],"categories":[],"sub_categories":[],"readme":"### Router:\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/tleckie/router.svg?style=flat-square)](https://packagist.org/packages/tleckie/router)\n[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/teodoroleckie/router/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/teodoroleckie/router/?branch=master)\n[![Build Status](https://scrutinizer-ci.com/g/teodoroleckie/router/badges/build.png?b=master)](https://scrutinizer-ci.com/g/teodoroleckie/router/build-status/master)\n[![Total Downloads](https://img.shields.io/packagist/dt/tleckie/router.svg?style=flat-square)](https://packagist.org/packages/tleckie/router)\n\nSimple and fast router PSR-7, PSR-17, PSR-15\n\n### Installation\n\nYou can install the package via composer:\n\n```bash\ncomposer require tleckie/router\n```\n\n### Usage\n\n```php\n\u003c?php\n\nuse HttpSoft\\Emitter\\SapiEmitter;\nuse HttpSoft\\Message\\ResponseFactory;\nuse HttpSoft\\Message\\ServerRequestFactory;\nuse Psr\\Http\\Message\\ResponseInterface;\nuse Psr\\Http\\Message\\ServerRequestInterface;\nuse Psr\\Http\\Server\\RequestHandlerInterface;\nuse Tleckie\\Router\\Router;\n\n$router = new Router(\n    new ServerRequestFactory(),\n    new ResponseFactory(),\n    new SapiEmitter()\n);\n\n\n/**\n * Class UserController\n *\n * @author Teodoro Leckie Westberg \u003cteodoroleckie@gmail.com\u003e\n */\nclass UserController\n{\n    /**\n     * @param ServerRequestInterface $request\n     * @param ResponseInterface      $response\n     * @param array                  $params\n     * @return ResponseInterface\n     */\n    public function retrieveUserAction(ServerRequestInterface $request, ResponseInterface $response, array $params): ResponseInterface\n    {\n        $response-\u003egetBody()-\u003ewrite(sprintf(\" CONTROLLER USER ID: %s\", $params['id']));\n\n        return $response-\u003ewithHeader('Content-Type', 'text/html');\n    }\n}\n\n// routing with middleware\n$router-\u003eget('/user/(?\u003cid\u003e[0-9]+)/',\n    static function (ServerRequestInterface $request, RequestHandlerInterface $handler, array $params) {\n\n        $response = $handler-\u003ehandle($request);\n        $response-\u003egetBody()-\u003ewrite(sprintf(' (ROUTES MIDDLEWARE ID: #%s) ', $params['id']));\n\n        return $response;\n    },\n    [new UserController, 'retrieveUserAction']\n);\n\n```\n\n### Add global middleware\n\nThe middleware added in the add method is always executed.\n```php\n\u003c?php\n\nrequire_once \"vendor/autoload.php\";\n\nuse HttpSoft\\Emitter\\SapiEmitter;\nuse HttpSoft\\Message\\ResponseFactory;\nuse HttpSoft\\Message\\ServerRequestFactory;\nuse Psr\\Http\\Message\\ResponseInterface;\nuse Psr\\Http\\Message\\ServerRequestInterface;\nuse Psr\\Http\\Server\\MiddlewareInterface;\nuse Psr\\Http\\Server\\RequestHandlerInterface;\nuse Tleckie\\Router\\Router;\n\n$router = new Router(\n    new ServerRequestFactory(),\n    new ResponseFactory(),\n    new SapiEmitter()\n);\n\n/**\n * Class ExampleMiddleware\n * @author Teodoro Leckie Westberg \u003cteodoroleckie@gmail.com\u003e\n */\nclass ExampleMiddleware implements MiddlewareInterface\n{\n    /**\n     * \u003cstrong\u003eObjects that implement MiddlewareInterface will not receive routing parameters\u003c/strong\u003e   \n     * @param ServerRequestInterface  $request\n     * @param RequestHandlerInterface $handler\n     * @return ResponseInterface\n     */\n    public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface\n    {\n        $response = $handler-\u003ehandle($request);\n        $response-\u003egetBody()-\u003ewrite(' (GLOBAL 1)');\n\n        return $response;\n    }\n}\n\n// Add app closure middleware. The closure middleware will receive the routing parameters\n$router-\u003eadd(static function (ServerRequestInterface $request, RequestHandlerInterface $handler, array $params){\n    \n    $response = $handler-\u003ehandle($request);\n    $response-\u003egetBody()-\u003ewrite(sprintf(' (GLOBAL ID: %s)', $params['id']));\n\n    return $response;\n});\n\n// app middleware.\n$router-\u003eadd(new ExampleMiddleware());\n\n```\n\nSupport for all methods.\n```php\n\u003c?php\n\nrequire_once \"vendor/autoload.php\";\n\nuse HttpSoft\\Emitter\\SapiEmitter;\nuse HttpSoft\\Message\\ResponseFactory;\nuse HttpSoft\\Message\\ServerRequestFactory;\nuse Psr\\Http\\Message\\ServerRequestInterface;\nuse Psr\\Http\\Server\\RequestHandlerInterface;\nuse Tleckie\\Router\\Router;\n\n$router = new Router(\n    new ServerRequestFactory(),\n    new ResponseFactory(),\n    new SapiEmitter()\n);\n\n$router-\u003eall('/user/(?\u003cid\u003e[0-9]+)/',\nstatic function (ServerRequestInterface $request, RequestHandlerInterface $handler, array $params) {\n\n        $response = $handler-\u003ehandle($request);\n        $response-\u003egetBody()-\u003ewrite(' (ROUTES MIDDLEWARE #1#)' . $params['id']);\n\n        return $response;\n    },\n    static function (ServerRequestInterface $request, RequestHandlerInterface $handler, array $params) {\n\n        $response = $handler-\u003ehandle($request);\n        $response-\u003egetBody()-\u003ewrite(' (ROUTES MIDDLEWARE #2#)' . $params['id']);\n\n        return $response;\n    },\n    [new UserController, 'retrieveUserAction']\n);\n```\n\n```php\n\u003c?php\n\nrequire_once \"vendor/autoload.php\";\n\nuse HttpSoft\\Emitter\\SapiEmitter;\nuse HttpSoft\\Message\\ResponseFactory;\nuse HttpSoft\\Message\\ServerRequestFactory;\nuse Psr\\Http\\Message\\ServerRequestInterface;\nuse Psr\\Http\\Server\\RequestHandlerInterface;\nuse Tleckie\\Router\\Exception\\RouteNotFoundException;\nuse Tleckie\\Router\\Router;\n\n$router = new Router(\n    new ServerRequestFactory(),\n    new ResponseFactory(),\n    new SapiEmitter()\n);\n\n$router-\u003epost('/user/(?\u003cid\u003e[0-9]+)/',\nstatic function (ServerRequestInterface $request, RequestHandlerInterface $handler, array $params) {\n\n        $response = $handler-\u003ehandle($request);\n        $response-\u003egetBody()-\u003ewrite(' (ROUTES MIDDLEWARE #1#)' . $params['id']);\n\n        return $response;\n    },\n    static function (ServerRequestInterface $request, RequestHandlerInterface $handler, array $params) {\n\n        $response = $handler-\u003ehandle($request);\n        $response-\u003egetBody()-\u003ewrite(' (ROUTES MIDDLEWARE #2#)' . $params['id']);\n\n        return $response;\n    },\n    [new UserController, 'retrieveUserAction']\n);\n\n\n\ntry {\n\n    $router-\u003erun(\n        $_SERVER['REQUEST_METHOD'],\n        $_SERVER['REDIRECT_URL'] ?? '/'\n    );\n\n} catch (RouteNotFoundException $exception) {\n    // handle 404\n}\n```\n\n### Methods:\nGET, POST, HEAD, PATCH, OPTIONS, DELETE, PUT,","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteodoroleckie%2Frouter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteodoroleckie%2Frouter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteodoroleckie%2Frouter/lists"}