PSR7 request body parser middleware.
PSR7 implementations doesn't normally parse request body to be available through $request->getParsedBody()
or they only do it for certain request methods or content types.
The best way to be fully confident that your request content will be parsed correctly while using the PSR7 implementation that you want is through the use of a middleware responsible of this task.
composer require juliangut/body-parser
Add as many content decoders as you want to cover your application needs based on request's Content-Type
header.
Decoders are assign to one or more HTTP methods.
Integrate in your middleware aware application workflow.
require './vendor/autoload.php';
use Jgut\BodyParser\Decoder\Json;
use Jgut\BodyParser\Decoder\Urlencoded;
use Jgut\BodyParser\Parser;
use Negotiator\Negtiator;
$bodyParser = new Parser(new Negotiator());
$bodyParser->addDecoder(new Urlencoded()); // Assigned to all requests
$bodyParser->addDecoder(new Json(), ['POST', 'PUT']); // Assigned only to POST and PUT requests
$app = new \YourMiddlewareAwareApplication();
$app->addMiddleware($bodyParser);
$app->run();
Review the documentation of the PSR7 implementation you use as it may already parse request body in some cases. You don't want to do the same job twice.
$decoder = new \Jgut\BodyParser\Decoder\UrlEncoded();
Supported MIME types:
- application/x-www-form-urlencoded
$decoder = new \Jgut\BodyParser\Decoder\Json();
Supported MIME types:
- application/json
- text/json
- application/x-json
$decoder = new \Jgut\BodyParser\Decoder\Xml();
Supported MIME types:
- application/xml
- text/xml
- application/x-xml
$decoder = new \Jgut\BodyParser\Decoder\Csv($delimiter = ',', $enclosure = '"', $escape = '\\');
Supported MIME types:
- text/csv
You can create your own decoder implementing Jgut\BodyParser\Decoder\Decoder
interface.
For example you could implement a YAML decoder for application/x-yaml
and text/yaml
MIME types.
Found a bug or have a feature request? Please open a new issue. Have a look at existing issues before.
See file CONTRIBUTING.md
See file LICENSE included with the source code for a copy of the license terms.