Request body parser PSR-15 middleware

PSR-15 middleware for parsing requests with JSON and URI encoded bodies regardless of HTTP method.

Version 2 calls request_parse_body() when applicable, which is when a webserver SAPI is used. This excludes running in test runners or CLI. It's also important to not consume the php://input stream or else an \Kekos\ParseRequestBodyMiddleware\ParserException will be thrown.

Install

You can install this package via Composer:

composer require kekos/multipart-form-data-parser

Documentation

Supported content types native PHP

MIME type	POST	PUT/PATCH
application/json
application/x-www-form-urlencoded	✓	*
multipart/form-data	✓	*

* Supported by calling request_parse_body() in PHP >= 8.4

Supported content types this package

This package acts like a polyfill for unsupported content types (JSON) and types only supported in POST methods by PHP.

MIME type	POST	PUT/PATCH
application/json	✓	✓
application/x-www-form-urlencoded		✓
multipart/form-data		✓

Usage

Add the \Kekos\ParseRequestBodyMiddleware\ParseRequestBodyMiddleware middleware to your PSR-15 handler, and it will populate ServerRequestInterface::getParsedBody() as array.

The parser will throw \Kekos\ParseRequestBodyMiddleware\ParserException if a malformed JSON body was sent.

Bugs and improvements

Report bugs in GitHub issues or feel free to make a pull request :-)

License

MIT