PHPackages gburtini/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. [Framework](/categories/framework) 4. / 5. gburtini/router ActiveLibrary[Framework](/categories/framework) gburtini/router =============== A very simple lightweight routing system capable of safe in-order fallbacks/priorities. All variables are treated as untainted. You should read the code (or at least 'Security' on the github page) before using this! 0.0.0(11y ago)223[1 issues](https://github.com/gburtini/PHP-Simple-Hierarchical-Router/issues)GPLPHPPHP >=5.3.0 Since Apr 4Pushed 10y ago2 watchersCompare [ Source](https://github.com/gburtini/PHP-Simple-Hierarchical-Router)[ Packagist](https://packagist.org/packages/gburtini/router)[ Docs](http://github.com/gburtini/PHP-Hierarchical-Router)[ RSS](/packages/gburtini-router/feed)WikiDiscussions master Synced 1w ago READMEChangelogDependenciesVersions (2)Used By (0) Hierarchical Router and Template Selector ========================================= [](#hierarchical-router-and-template-selector) *Fallback friendly routing tool.* You might want to check out before using this. In general, the philosophy here is to use the filesystem as the core routing functionality. The most common architecture is broadly as follows: - Using `mod_rewrite` or similar, route all traffic to a parser and initialization script. - Parse out the intended "route" and variables. *VALIDATE THE ROUTE AGAINST A WHITELIST.* - `Route::map` to the appropriate file (usually a 'controller' file), passing in whitelisted variables as necessary as 'parameters'. - Perform controller action. - `Route::map` to the appropriate template file with whitelisted variables to output the final template. Installation ------------ [](#installation) Everything you need is contained within the single file `router.php`, but the most convenient way to install is with composer: ``` composer require gburtini/router ``` Usage ----- [](#usage) Set up your valid routing types with a call to `::types`. The key is an indicator for the type and the value is the path, without trailing slash. A path of "/" is not acceptable. A path of "" is acceptable, but not recommended as, at a minimum, you could get in a infinite loop (you also would have no control over which files get routed to). ``` Route::types(['controller'=>'files/controllers', 'template'=>'files/templates']); ``` Set up valid extensions for your files. This is a trinket of security against loading bad files. By default, this is set to `["php"]`. ``` Route::extensions(["tpl", "html"]); ``` When you wish to invoke a route, call `::map` or `::%type name%`. `::map` will take an array of types to route to in precedence order. A single route call will only ever route to one file. ``` Route::map(['controller', 'template'], 'dashboard'); ``` If you don't need the fallback functionality (controller then template if controller doesn't exist), you can use interpreter hooks / magic methods to directly use your established types: ``` Route::template("dashboard"); ``` Security -------- [](#security) tl;dr: When in doubt, you should assure all variables you pass in to the router are untained, secure, safe. Very little validation is performed. `Route::types` does no validation. Paths are not verified to not be dangerous, empty or root. `Route::map` and related functions (magic methods, `Route::mapFile`) will not prevent you from including dangerous files. Specifically: - If the type selected has an empty path, the path will currently begin from "/" - If the second parameter to map (first parameter to magic methods) is empty, the router will cowardly refuse to try to load it. - If the second parameter to map contains "..", it will *navigate up the path as expected*. If this is not your desired behavior, you should whitelist. If you do not want to whitelist, the code could be modified to use `realpath` to validate the prefix. - The third parameter to ::map takes in a map of parameters to expand in the included file. Currently, this uses `extract(., EXTR_SKIP)` to expand the map. `EXTR_SKIP` means that any of the variables used within the map function (including `$path`, `$load`) cannot be passed. This is not a security risk (in the router, it could be in your code!) but you should use a prefix (or modify the code to support a more general extraction mechanism) for all variables passed through. - There are more considerations. Most of them related to the path. You *should read the code before using it*. It is unlikely this code will be "ready to use" for all purposes currently. License ------- [](#license) *Copyright (C) 2015 Giuseppe Burtini* This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . ### Health Score 21 — LowBetter than 18% of packages Maintenance10 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community8 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 Unknown Total 1 Last Release 4084d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/ae4c24da012c0348f5c1555bd9aa3088c43ce6d4bcad11652f12a6c6e37a4f3b?d=identicon)[gburtini](/maintainers/gburtini) --- Top Contributors [![gburtini](https://avatars.githubusercontent.com/u/780031?v=4)](https://github.com/gburtini "gburtini (6 commits)") --- Tags routerroutingmappinglightweightroutefile system ### Embed Badge ![Health badge](/badges/gburtini-router/health.svg) ``` [![Health](https://phpackages.com/badges/gburtini-router/health.svg)](https://phpackages.com/packages/gburtini-router) ``` ### Alternatives [pecee/simple-router Simple, fast PHP router that is easy to get integrated and in almost any project. Heavily inspired by the Laravel router. 675224.9k18](/packages/pecee-simple-router)[izniburak/router simple router class for php 23423.2k7](/packages/izniburak-router)[ecoal95/php-router Minimal routing library 271.0k1](/packages/ecoal95-php-router)[heropoo/routing A simple and fast route. Use tree structure storage, fast matching! 105.6k1](/packages/heropoo-routing)[developermarius/simple-router Simple, fast PHP router that is easy to get integrated and in almost any project. Heavily inspired by the Laravel router. 112.5k](/packages/developermarius-simple-router) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)