Skip to content

Note about PSR-15 middleware #304

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
WyriHaximus wants to merge 4 commits into from
Closed

Note about PSR-15 middleware #304

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
407dae7
Note about PSR-15 middleware
WyriHaximus Jan 23, 2018
c77bcfc
Dropped "Additionally" by suggestion of @jsor at https://github.com/r…
WyriHaximus Feb 1, 2018
b19e13b
Reworded PSR-15 Middleware section after feedback from @clue at https…
WyriHaximus Feb 7, 2018
9e692b1
Reworded the ongoing into its actual status: PSR-15
WyriHaximus Feb 7, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ Event-driven, streaming plaintext HTTP and secure HTTPS server for [ReactPHP](ht
* [RequestBodyBufferMiddleware](#requestbodybuffermiddleware)
* [RequestBodyParserMiddleware](#requestbodyparsermiddleware)
* [Third-Party Middleware](#third-party-middleware)
* [PSR-15 Middleware](#psr-15-middleware)
* [Install](#install)
* [Tests](#tests)
* [License](#license)
Expand Down Expand Up @@ -827,7 +828,7 @@ or use a class based approach to ease using existing middleware implementations.
While this project does provide the means to *use* middleware implementations,
it does not aim to *define* how middleware implementations should look like.
We realize that there's a vivid ecosystem of middleware implementations and
ongoing effort to standardize interfaces between these and support this goal.
that is has its standard in [PSR-15 Middleware](#psr-15-middleware).
As such, this project only bundles a few middleware implementations that are
required to match PHP's request behavior (see below) and otherwise actively
encourages [Third-Party Middleware](#third-party-middleware) implementations.
Expand Down Expand Up @@ -1129,6 +1130,15 @@ new RequestBodyParserMiddleware(10 * 1024, 100); // 100 files with 10 KiB each

A non-exhaustive list of third-party middleware can be found at the [`Middleware`](https://github.com/reactphp/http/wiki/Middleware) wiki page.

#### PSR-15 Middleware

While we would love to support PSR-15 directly in `react/http` we choose a different path for middleware. One with
promises as expected return value, where the PSR-15 `MiddlewareInterface` and `RequestHandlerInterface` enforce
`ResponseInterface`. This isn't achievable with out on the fly changing of code, which is beyond the scope of this
package. However, our friends over at [Friends of ReactPHP](https://github.com/friends-of-reactphp) did came up with a
solution that makes using most PSR-15 middleware possible with `react/http` using the
[PSR-15 middleware adapter](https://github.com/friends-of-reactphp/http-middleware-psr15-adapter).

## Install

The recommended way to install this library is [through Composer](https://getcomposer.org).
Expand Down