PHPackages                             symplify/modular-routing - 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. symplify/modular-routing

Abandoned → [symplify/framework-bundle](/?search=symplify%2Fframework-bundle)Library[Utility & Helpers](/categories/utility)

symplify/modular-routing
========================

Load your Symfony routes with a simple service.

v1.4.10(9y ago)176.9k2PHPPHP ^7.1

Since Jan 23Pushed 9y ago4 watchersCompare

[ Source](https://github.com/deprecated-packages/SymfonyModularRouting)[ Packagist](https://packagist.org/packages/symplify/modular-routing)[ RSS](/packages/symplify-modular-routing/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependencies (18)Versions (41)Used By (0)

Modular Routing
===============

[](#modular-routing)

[![Build Status](https://camo.githubusercontent.com/0e98d34dcb5e861306a7a20744b35deefb0bacb9e2a22b5a74be40bd626b9224/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f53796d706c6966792f4d6f64756c6172526f7574696e672f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/Symplify/ModularRouting)[![Downloads](https://camo.githubusercontent.com/547bf0339ecac095c4466757576505b247184ad5df5621d22e351d5282e489c3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73796d706c6966792f6d6f64756c61722d726f7574696e672e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/symplify/modular-routing)

To add routes you usually need to add few lines to `app/config/routing.yml`. If you have over dozens of modules, it would be easy to get lost in it. To see all options on how to do that including this package, read [this short article](http://www.tomasvotruba.cz/blog/2016/02/25/modular-routing-in-symfony).

**Thanks to this router, you can add them easily as via service loader**.

Install
-------

[](#install)

```
composer require symplify/modular-routing
```

Add bundle to `AppKernel.php`:

```
final class AppKernel extends Kernel
{
    public function registerBundles(): array
    {
        $bundles = [
            new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
            new Symfony\Cmf\Bundle\RoutingBundle\CmfRoutingBundle(),
            new Symplify\ModularRouting\SymplifyModularRoutingBundle(),
            // ...
        ];
    }
}
```

Usage
-----

[](#usage)

1. Implement [`RouteCollectionProviderInterface`](src/Contract/Routing/RouteCollectionProviderInterface.php)

    ```
    use Symfony\Component\Routing\Route;
    use Symfony\Component\Routing\RouteCollection;
    use Symplify\ModularRouting\Contract\Routing\RouteCollectionProviderInterface;

    final class SomeRouteCollectionProvider implements RouteCollectionProviderInterface
    {
        public function getRouteCollection() : RouteCollection
        {
            $routeCollection = new RouteCollection();
            $routeCollection->add('my_route', new Route('/hello'));

            return $routeCollection;
        }
    }
    ```
2. Register service

    ```
    services:
        some_module.route_provider:
            class: SomeModule\Routing\SomeRouteCollectionProvider
            autowire: true # or better use Symplify\DefaultAutowire package
    ```

That's all!

### Loading YML/XML files

[](#loading-ymlxml-files)

In case you want to load these files, just use [`AbstractRouteCollectionProvider`](src/Routing/AbstractRouteCollectionProvider.php)with helper methods.

```
use Symfony\Component\Routing\RouteCollection;
use Symplify\ModularRouting\Routing\AbstractRouteCollectionProvider;

final class FilesRouteCollectionProvider extends AbstractRouteCollectionProvider
{
    public function getRouteCollection(): RouteCollection
    {
        return $this->loadRouteCollectionFromFiles([
            __DIR__ . '/routes.xml',
            __DIR__ . '/routes.yml',
        ]);

        // on in case you have only 1 file
        // return $this->loadRouteCollectionFromFile(__DIR__ . '/routes.yml');
    }
}
```

Contributing
------------

[](#contributing)

Send [issue](https://github.com/Symplify/Symplify/issues) or [pull-request](https://github.com/Symplify/Symplify/pulls) to main repository.

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity70

Established project with proven stability

 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

Every ~12 days

Total

40

Last Release

3349d ago

Major Versions

v0.4.1 → v1.0.02016-07-18

v1.4.10 → v2.0.0-RC12017-04-14

PHP version history (3 changes)v0.1.0PHP ^7.0

v0.3.0PHP ^5.6|^7.0

v1.4.0PHP ^7.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/924196?v=4)[Tomas Votruba](/maintainers/TomasVotruba)[@TomasVotruba](https://github.com/TomasVotruba)

---

Top Contributors

[![TomasVotruba](https://avatars.githubusercontent.com/u/924196?v=4)](https://github.com/TomasVotruba "TomasVotruba (74 commits)")

---

Tags

modularphpphp71routingsymfonysymfony32symplify

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/symplify-modular-routing/health.svg)

```
[![Health](https://phpackages.com/badges/symplify-modular-routing/health.svg)](https://phpackages.com/packages/symplify-modular-routing)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.5M378](/packages/easycorp-easyadmin-bundle)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[chameleon-system/chameleon-base

The Chameleon System core.

1027.9k4](/packages/chameleon-system-chameleon-base)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

9317.2k55](/packages/open-dxp-opendxp)[pimcore/pimcore

Content & Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.8M464](/packages/pimcore-pimcore)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.4M524](/packages/shopware-core)

PHPackages © 2026

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