amphp / http-server-form-parser
An HTTP server plugin that simplifies form data handling. Effortlessly parse incoming form submissions and extracting its data.
Fund package maintenance!
amphp
Installs: 72 352
Dependents: 15
Suggesters: 0
Security: 0
Stars: 18
Watchers: 8
Forks: 6
Open Issues: 1
Language:HTML
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
This package is auto-updated.
Last update: 2024-10-25 05:31:29 UTC
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.