PHPackages steampixel/simple-php-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. steampixel/simple-php-router ActiveLibrary[Framework](/categories/framework) steampixel/simple-php-router ============================ This is a simple and small PHP router that can handle the whole url routing for your project. 0.7.1(3y ago)41567.1k↑42.1%111[3 issues](https://github.com/steampixel/simplePHPRouter/issues)2MITPHP Since Jan 14Pushed 7mo ago31 watchersCompare [ Source](https://github.com/steampixel/simplePHPRouter)[ Packagist](https://packagist.org/packages/steampixel/simple-php-router)[ RSS](/packages/steampixel-simple-php-router/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (12)Used By (2) Simple PHP Router ⇄ =================== [](#simple-php-router-) Hey! This is a simple and small single class PHP router that can handle the whole URL routing for your project. It utilizes RegExp and PHP's anonymous functions to create a lightweight and fast routing system. The router supports dynamic path parameters, special 404 and 405 routes as well as verification of request methods like GET, POST, PUT, DELETE, etc. The codebase is very small and very easy to understand. So you can use it as a boilerplate for a more complex router. Take a look at the index.php file. As you can see the `Route::add()` method is used to add new routes to your project. The first argument takes the path segment. You can also use RegExp in there to parse out variables. All matching variables will be pushed to the handler method defined in the second argument. The third argument will match the request method. The default method is 'get'. 📋 Simple example: ----------------- [](#-simple-example) ``` // Require the class include 'src\Steampixel\Route.php'; // Use this namespace use Steampixel\Route; // Add the first route Route::add('/user/([0-9]*)/edit', function($id) { echo 'Edit user with id '.$id.''; }, 'get'); // Run the router Route::run('/'); ``` You will find a more complex example with a build in navigation in the index.php file. 🎶 Installation using Composer ----------------------------- [](#-installation-using-composer) Just run `composer require steampixel/simple-php-router`Than add the autoloader to your project like this: ``` // Autoload files using composer require_once __DIR__ . '/vendor/autoload.php'; // Use this namespace use Steampixel\Route; // Add your first route Route::add('/', function() { echo 'Welcome :-)'; }); // Run the router Route::run('/'); ``` ⛺ Use a different basepath -------------------------- [](#-use-a-different-basepath) If your script lives in a subfolder (e.g. /api/v1) set this basepath in your run method: ``` Route::run('/api/v1'); ``` Do not forget to edit the basepath in .htaccess too if you are on Apache2. ⏎ Use return instead of echo ---------------------------- [](#-use-return-instead-of-echo) You don't have to use `echo` to output your content. You can also use the `return` statement. Everything that gets returned is echoed automatically. ``` // Add your first route Route::add('/', function() { return 'Welcome :-)'; }); ``` ⇒ Use arrow functions --------------------- [](#-use-arrow-functions) Since PHP 7.4 you can also use arrow functions to output your content. So you can easily use variables from outside and you can write shorter code. Please be aware that an Arrow function must always return a value. Therefore you cannot use `echo` directly in here. You can find an example in index.php. However, this is deactivated, as it only works from PHP 7.4. ``` Route::add('/arrow/([a-z-0-9-]*)', fn($foo) => 'This is a working arrow function example. Parameter: '.$foo ); ``` 📖 Return all known routes ------------------------- [](#-return-all-known-routes) This is useful, for example, to automatically generate test routes or help pages. ``` $routes = Route::getAll(); foreach($routes as $route) { echo $route['expression'].' ('.$route['method'].')'; } ``` On top of that you could use a library like to generate working example links for the different expressions. 🧰 Enable case sensitive routes, trailing slashes and multi match mode --------------------------------------------------------------------- [](#-enable-case-sensitive-routes-trailing-slashes-and-multi-match-mode) The second, third and fourth parameters of `Route::run('/', false, false, false);` are set to false by default. Using this parameters you can switch on and off several options: - Second parameter: You can enable case sensitive mode by setting the second parameter to true. - Third parameter: By default the router will ignore trailing slashes. Set this parameter to true to avoid this. - Fourth parameter: By default the router will only execute the first matching route. Set this parameter to true to enable multi match mode. ⁉ Something does not work? -------------------------- [](#-something-does-not-work) - Don't forget to set the correct basepath as the first argument in your `run()` method and in your .htaccess file. - Enable mod\_rewrite in your Apache2 settings, in case you're using Apache2: `a2enmod apache2` - Does Apache2 even load the .htaccess file? Check whether the `AllowOverride All` option is set in the Apache2 configuration like in this example: ``` ServerName mysite.com DocumentRoot /var/www/html/mysite.com AllowOverride All ``` 🚀 Pages, Templates, Themes, Components -------------------------------------- [](#-pages-templates-themes-components) This is a simple router. So there is no templating at all. But it works perfectly together with [simplePHPComponents](https://github.com/steampixel/simplePHPComponents) and [simplePHPPortals](https://github.com/steampixel/simplePHPPortals). There is a complete boilerplate project including these dependencies and this router called [simplePHPPages](https://github.com/steampixel/simplePHPPages). You can use it for you next project. 🎓 What skills do you need? -------------------------- [](#-what-skills-do-you-need) Please be aware that for this router you need a basic understanding of PHP. Many problems stem from people lacking basic programming knowledge. You should therefore have the following skills: - Basic PHP Knowledge - Basic understanding of RegExp in PHP: - Basic understanding of anonymous functions and how to push data inside it: - Basic understanding of including and requiring files and how to push data to them: - Windows Only - Setup IIS and PHP: . - Windows Only - Creating Websites in IIS: . Please note that we are happy to help you if you have problems with this router. Unfortunately, we don't have a lot of time, so we can't help you learn PHP basics. 🚢 Test setup with Docker ------------------------ [](#-test-setup-with-docker) I have created a little Docker test setup. 1. Build the image: `docker build -t simplephprouter docker/image-php-7.2` 2. Spin up a container - On Linux / Mac or Windows Powershell use: `docker run -d -p 80:80 -v $(pwd):/var/www/html --name simplephprouter simplephprouter` - On Windows CMD use `docker run -d -p 80:80 -v %cd%:/var/www/html --name simplephprouter simplephprouter` 3. Open your browser and navigate to 🪟 Test Setup in Windows using IIS --------------------------------- [](#-test-setup-in-windows-using-iis) With IIS now fully supporting PHP, this example can be run using the included web.config. The web.config has a rewrite rule, similar to the .htaccess rewrite rule, but specifically for IIS. The rewrite rule will send all incoming requests to index.php in your root. The rest is done by the simple php router. ### Setup [](#setup) *This setup tutorial assumes you have the knowledge to create sites in IIS and set up bindings for http/https and custom DNS. If you need more information, this [article](https://docs.microsoft.com/en-us/iis/get-started/getting-started-with-iis/create-a-web-site) will help you with that part.* 1. If you haven't done so yet, install php on windows. This article [Install IIS and PHP | Microsoft Docs ](https://docs.microsoft.com/en-us/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-1-install-iis-and-php) will guide you to install the required php dependencies on your windows machine. 2. In IIS Manager, create a site and point the physical location to root of the simplePHPRouter folder. It is recommended you connect to the the physical location with an account that has "Read/Write" rights to that folder. 3. (Optional) Create a DNS entry in your hosts file pointing 127.0.0.1 to the domain name you have used to set up the site. 4. Browse to the newly created website and the sample site should display now. ✅ Todo ------ [](#-todo) - Create demo configuration for nginx 📃 License --------- [](#-license) This project is licensed under the MIT License. See LICENSE for further information. ### Health Score 47 — FairBetter than 94% of packages Maintenance45 Moderate activity, may be stable Popularity53 Moderate usage in the ecosystem Community29 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 90% 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 ~111 days Recently: every ~159 days Total 10 Last Release 1314d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/be023f708ac14d5baa23edc4636e14ff1cf1c58b7f22f33fce880fd012028252?d=identicon)[steampixel](/maintainers/steampixel) --- Top Contributors [![steampixel](https://avatars.githubusercontent.com/u/2643394?v=4)](https://github.com/steampixel "steampixel (81 commits)")[![ImMaax](https://avatars.githubusercontent.com/u/40642083?v=4)](https://github.com/ImMaax "ImMaax (5 commits)")[![syrian-dev](https://avatars.githubusercontent.com/u/16126451?v=4)](https://github.com/syrian-dev "syrian-dev (2 commits)")[![beopuppy](https://avatars.githubusercontent.com/u/3517405?v=4)](https://github.com/beopuppy "beopuppy (1 commits)")[![mzaini30](https://avatars.githubusercontent.com/u/7939342?v=4)](https://github.com/mzaini30 "mzaini30 (1 commits)") --- Tags phpphp-routerurl-parser ### Embed Badge ![Health badge](/badges/steampixel-simple-php-router/health.svg) ``` [![Health](https://phpackages.com/badges/steampixel-simple-php-router/health.svg)](https://phpackages.com/packages/steampixel-simple-php-router) ``` ### Alternatives [laravel/passport Laravel Passport provides OAuth2 server support to Laravel. 3.4k85.0M532](/packages/laravel-passport)[nolimits4web/swiper Most modern mobile touch slider and framework with hardware accelerated transitions 41.8k177.2k1](/packages/nolimits4web-swiper)[laravel/dusk Laravel Dusk provides simple end-to-end testing and browser automation. 1.9k36.7M259](/packages/laravel-dusk)[laravel/prompts Add beautiful and user-friendly forms to your command-line applications. 712181.8M596](/packages/laravel-prompts)[cakephp/chronos A simple API extension for DateTime. 1.4k47.7M121](/packages/cakephp-chronos)[laravel/pail Easily delve into your Laravel application's log files directly from the command line. 91545.3M590](/packages/laravel-pail) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)