PHPackages                             causal/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. [HTTP &amp; Networking](/categories/http)
4. /
5. causal/routing

ActiveTypo3-cms-extension[HTTP &amp; Networking](/categories/http)

causal/routing
==============

Service to route HTTP/REST requests to your own controller/actions.

0.5.0(8y ago)1919.9k6[6 issues](https://github.com/xperseguers/t3ext-routing/issues)[1 PRs](https://github.com/xperseguers/t3ext-routing/pulls)GPL-2.0+PHPPHP &gt;= 5.5.0, &lt;= 7.2.99

Since Dec 18Pushed 5y ago3 watchersCompare

[ Source](https://github.com/xperseguers/t3ext-routing)[ Packagist](https://packagist.org/packages/causal/routing)[ Docs](https://github.com/xperseguers/t3ext-routing)[ RSS](/packages/causal-routing/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (5)Used By (0)

Request Routing Service
=======================

[](#request-routing-service)

Service to route HTTP/REST requests to your own controller/actions.

**Good to know:** The routing is inspired by the way Flow's router works ([read more](https://flowframework.readthedocs.io/en/6.3/TheDefinitiveGuide/PartIII/Routing.html)).

What does it do?
----------------

[](#what-does-it-do)

This extension lets you route requests like:

```
http://localhost/routing/extension-key/my-demo/1234
http://localhost/routing/extension-key/my-demo/1234.json
http://localhost/routing/extension-key/my-demo/99

```

to any controller/action based on a YAML-based routing configuration. In this example, where `1234` and `99` will be mapped to some method argument (and converted to domain object if needed) and `json` will set the response format to `json`.

Sample Routing
--------------

[](#sample-routing)

The routing is stored as `Configuration/Routes.yaml` (or `Configuration/Routes.yml`) and looks like that

```
-
  name: 'Demo action with a parameter in a given format (JSON, ...)'
  uriPattern: 'my-demo/{value}.{@format}'
  defaults:
    '@package':    'MyVendor.ExtensionKey'
    '@plugin':     'API'
    '@controller': 'Dummy'
    '@action':     'demo'
-
  name: 'Demo action with a parameter'
  uriPattern: 'my-demo/{value}'
  defaults:
    '@package':    'MyVendor.ExtensionKey'
    '@plugin':     'API'
    '@controller': 'Dummy'
    '@action':     'demo'

```

The name of the route is sent as additional header in the response:

[![Additional HTTP header "X-Causal-Routing-Route"](https://raw.githubusercontent.com/xperseguers/t3ext-routing/master/Documentation/Images/headers.png "Additional HTTP header 'X-Causal-Routing-Route'")](https://raw.githubusercontent.com/xperseguers/t3ext-routing/master/Documentation/Images/headers.png)

Installation
------------

[](#installation)

1. Install extension with packagist:

    ```
    composer req causal/routing

    ```
2. Go to Extension Manager and activate extension `routing`
3. Add a rewrite rule to your `.htaccess`:

    ```
    RewriteRule ^routing/(.*)$ /index.php?eID=routing&route=$1 [QSA,L]

    ```

    or, if you are using Nginx:

    ```
    rewrite ^/routing/(.*)$ /index.php?eID=routing&route=$1 last;

    ```

This will have the effect of using this extension for handling requests starting with `routing/`.

**Tip:** If you need to support localization (`&L=`), then you should change the suggesting routing above to include the root page uid of your website (`&id=`). This is needed because localization mode and default language may differ in complex environments and thus cannot be inferred.

Read more in the [manual](https://docs.typo3.org/typo3cms/extensions/routing/).

Compatibility with TYPO3 v8
---------------------------

[](#compatibility-with-typo3-v8)

Since [change 78002](https://docs.typo3.org/typo3cms/extensions/core/8.7/Changelog/8.5/Breaking-78002-EnforceCHashArgumentForExtbaseActions.html), you need to adapt your TypoScript so that `cHash` is not required:

```
plugin.tx_ {
    features {
        requireCHashArgumentForActionArguments = 0
    }
}

```

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance14

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 92.3% 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 ~360 days

Total

4

Last Release

3087d ago

PHP version history (3 changes)0.2.0PHP &gt;= 5.3.3, &lt;= 5.6.99

0.4.0PHP &gt;= 5.3.3, &lt;= 7.0.99

0.5.0PHP &gt;= 5.5.0, &lt;= 7.2.99

### Community

Maintainers

![](https://www.gravatar.com/avatar/a04cce579abca57a056f0716f909fcf37ec60e227ee92cc4b58d18ee9aad62a2?d=identicon)[xperseguers](/maintainers/xperseguers)

---

Top Contributors

[![xperseguers](https://avatars.githubusercontent.com/u/646805?v=4)](https://github.com/xperseguers "xperseguers (60 commits)")[![tantegerda1](https://avatars.githubusercontent.com/u/4216652?v=4)](https://github.com/tantegerda1 "tantegerda1 (3 commits)")[![AlexKvrlp](https://avatars.githubusercontent.com/u/31535838?v=4)](https://github.com/AlexKvrlp "AlexKvrlp (1 commits)")[![SomeBdyElse](https://avatars.githubusercontent.com/u/243504?v=4)](https://github.com/SomeBdyElse "SomeBdyElse (1 commits)")

---

Tags

restweb serviceroutingTYPO3 CMShttp request

### Embed Badge

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

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

###  Alternatives

[handcraftedinthealps/rest-routing-bundle

This bundle provides automatic route registration for the Controllers

582.0M2](/packages/handcraftedinthealps-rest-routing-bundle)[abantecart/ups-php

UPS PHP SDK based on OAuth

1815.3k](/packages/abantecart-ups-php)[apoca/laravel-sibs-payments

Laravel library to communicate with SIBS - Open Payment Platform.

342.3k](/packages/apoca-laravel-sibs-payments)

PHPackages © 2026

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