PHPackages                             cormy/onion - 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 & Networking](/categories/http)
4. /
5. cormy/onion

ActiveLibrary[HTTP & Networking](/categories/http)

cormy/onion
===========

Onion style PSR-7 middleware stack using generators

0.2.0(9y ago)2211MITPHPPHP >=7

Since Nov 20Pushed 9y ago1 watchersCompare

[ Source](https://github.com/cormy/onion)[ Packagist](https://packagist.org/packages/cormy/onion)[ RSS](/packages/cormy-onion/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (6)Versions (4)Used By (0)

Cormy Onion [![Build Status](https://camo.githubusercontent.com/0274cd27772b85a8e6d7f828aa874937571ab142c3b4312b52933f3623072e29/68747470733a2f2f7472617669732d63692e6f72672f636f726d792f6f6e696f6e2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/cormy/onion) [![Coverage Status](https://camo.githubusercontent.com/7f3d1aec543f6db04d856c851c9d93b19855cd50002d347790f912ba440e1394/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f636f726d792f6f6e696f6e2f62616467652e7376673f6272616e63683d6d617374657226736572766963653d676974687562)](https://coveralls.io/github/cormy/onion?branch=master) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/a3803b678be8cb89fd1c9933f47c715778ef09420c2c38dd06319cdf6e4a710e/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f636f726d792f6f6e696f6e2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/cormy/onion/?branch=master)
=========================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#cormy-onion---)

[![SensioLabsInsight](https://camo.githubusercontent.com/268df2152a33adfa25609c56c27dee85fef45aec115bd28d608d33ccf1dbbac3/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f34376532383366332d326561662d343831362d623735612d3535386464303830326264642f6269672e706e67)](https://insight.sensiolabs.com/projects/47e283f3-2eaf-4816-b75a-558dd0802bdd)

> 🌷 Onion style [PSR-7](http://www.php-fig.org/psr/psr-7) **middleware stack** using generators

Install
-------

[](#install)

```
composer require cormy/onion

```

Usage
-----

[](#usage)

```
use Cormy\Server\Onion;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;

// create the core of the onion, i.e. the innermost request handler
$core = function (ServerRequestInterface $request):ResponseInterface {
    return new \Zend\Diactoros\Response();
};

// create some scales (aka middlewares) to wrap around the core
$scales = [];

$scales[] = function (ServerRequestInterface $request):\Generator {
    // delegate $request to the next request handler, i.e. $core
    $response = (yield $request);

    return $response->withHeader('content-type', 'application/json; charset=utf-8');
};

$scales[] = function (ServerRequestInterface $request):\Generator {
    // delegate $request to the next request handler, i.e. the middleware right above
    $response = (yield $request);

    return $response->withHeader('X-PoweredBy', 'Unicorns');
};

// create an onion style middleware stack
$middlewareStack = new Onion($core, ...$scales);

// and process an incoming server request
$response = $middlewareStack(new \Zend\Diactoros\ServerRequest());
```

API
---

[](#api)

### `Cormy\Server\Onion implements RequestHandlerInterface`

[](#cormyserveronion-implements-requesthandlerinterface)

#### `Onion::__construct`

[](#onion__construct)

```
/**
 * Constructs an onion style PSR-7 middleware stack.
 *
 * @param RequestHandlerInterface|callable                         $core   the innermost request handler
 * @param (MiddlewareInterface|RequestHandlerInterface|callable)[] $scales the middlewares to wrap around the core
 */
public function __construct(callable $core, callable ...$scales)
```

#### Inherited from [`RequestHandlerInterface::__invoke`](https://github.com/cormy/server-request-handler)

[](#inherited-from-requesthandlerinterface__invoke)

```
/**
 * Process an incoming server request and return the response.
 *
 * @param ServerRequestInterface $request
 *
 * @return ResponseInterface
 */
public function __invoke(ServerRequestInterface $request):ResponseInterface
```

Related
-------

[](#related)

- [Cormy\\Server\\Bamboo](https://github.com/cormy/bamboo) – Bamboo style PSR-7 **middleware pipe** using generators
- [Cormy\\Server\\MiddlewareDispatcher](https://github.com/cormy/cormy/server-middleware-dispatcher) – Cormy PSR-7 server **middleware dispatcher**
- [Cormy\\Server\\RequestHandlerInterface](https://github.com/cormy/server-request-handler) – Common interfaces for PSR-7 server request handlers
- [Cormy\\Server\\MiddlewareInterface](https://github.com/cormy/server-middleware) – Common interfaces for Cormy PSR-7 server middlewares

License
-------

[](#license)

MIT © [Michael Mayer](http://schnittstabil.de)

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity55

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

Every ~6 days

Total

3

Last Release

3443d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6059032?v=4)[Michael Mayer](/maintainers/schnittstabil)[@schnittstabil](https://github.com/schnittstabil)

---

Top Contributors

[![schnittstabil](https://avatars.githubusercontent.com/u/6059032?v=4)](https://github.com/schnittstabil "schnittstabil (10 commits)")

---

Tags

httpresponserequestpsrpsr-7http-messagemiddlewarestackonioncormy

### Embed Badge

![Health badge](/badges/cormy-onion/health.svg)

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

###  Alternatives

[psr/http-message

Common interface for HTTP messages

7.1k1.0B5.5k](/packages/psr-http-message)[psr/http-server-middleware

Common interface for HTTP server-side middleware

18091.2M1.5k](/packages/psr-http-server-middleware)[fig/http-message-util

Utility classes and constants for use with PSR-7 (psr/http-message)

39489.0M271](/packages/fig-http-message-util)[idealo/php-middleware-stack

Implementation of HTTP Middleware PSR-15 specification

318.9k](/packages/idealo-php-middleware-stack)[art4/requests-psr18-adapter

Use WordPress/Requests as a PSR-18 HTTP client

153.3k](/packages/art4-requests-psr18-adapter)

PHPackages © 2026

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