amphp/http-server-form-parser

An HTTP server plugin that simplifies form data handling. Effortlessly parse incoming form submissions and extracting its data.

v2.0.0 2023-08-25 02:52 UTC

Requires

• php: >=8.1
• amphp/amp: ^3
• amphp/byte-stream: ^2
• amphp/http: ^2
• amphp/http-server: ^3.2
• amphp/pipeline: ^1
• revolt/event-loop: ^1

Requires (Dev)

• amphp/log: ^2
• amphp/php-cs-fixer-config: ^2
• amphp/phpunit-util: ^3
• phpunit/phpunit: ^9
• psalm/phar: ^5.6

MIT

• Daniel Lowrey
• Bob Weinand
• Niklas Keller
• Aaron Piotrowski

• http
• form
• async
• non-blocking
• amp
• amphp
• revolt

README

This package is an add-on to amphp/http-server, which allows parsing request bodies as forms in either x-www-form-urlencoded or multipart/form-data format.

Installation

This package can be installed as a Composer dependency.

composer require amphp/http-server-form-parser

Usage

Basic usage works by calling Form::fromRequest($request), which will buffer the request body and parse it. This method may be called multiple times, so both a middleware and request handler may access the form body.

use Amp\Http\Server\FormParser\Form;
use Amp\Http\Server\Request;
use Amp\Http\Server\RequestHandler\ClosureRequestHandler;
use Amp\Http\Server\Response;
use Amp\Http\Status;

$requestHandler = new ClosureRequestHandler(function (Request $request) {
    $form = Form::fromRequest($request);

    return new Response(Status::OK, [
        "content-type" => "text/plain; charset=utf-8"
    ], $form->getValue("text") ?? "Hello, World!");
});

There's also an advanced streaming parser included, StreamingFormParser, which can be used to stream uploaded files to disk or other locations.