Set of classes to parse any stream into innmind/http
objects.
This is useful if you want to parse requests saved in files or build an http server.
Features supported:
- Decoding requests
- Reading streamed requests with
Transfer-Encoding: chunked
- Extracting
Cookie
s - Extracting form data
- Extracting query data
- Reading multipart bodies
composer require innmind/http-parser
use Innmind\HttpParser\{
Request\Parse,
ServerRequest\Transform,
ServerRequest\DecodeCookie,
ServerRequest\DecodeQuery,
ServerRequest\DecodeForm,
};
use Innmind\TimeContinuum\Earth\Clock;
use Innmind\IO\IO;
use Innmind\Stream\Streams;
use Innmind\Http\Message\ServerRequest;
use Innmind\Immutable\Str;
// this data could come from anywhere
$raw = <<<RAW
POST /some-form HTTP/1.1
Host: innmind.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 23
Accept-Language: fr-fr
Cookie: PHPSESSID=298zf09hf012fh2; csrftoken=u32t4o3tb3gg43; _gat=1
some[key]=value&foo=bar
RAW;
$streams = Streams::fromAmbientAuthority();
$io = IO::of(static fn($timeout) => match ($timeout) {
null => $streams->watch()->waitForever(),
default => $streams->watch()->timeoutAfter($timeout),
});
$parse = Parse::default(new Clock);
$stream = $streams
->temporary()
->new()
->write(Str::of($raw))
->flatMap(static fn($stream) => $stream->rewind())
->match(
static fn($stream) => $stream,
static fn() => throw new \RuntimeException('Stream not writable'),
);
$stream = $io
->readable()
->wrap($stream)
->watch();
$request = $parse($stream)
->map(Transform::of())
->map(DecodeCookie::of())
->map(DecodeQuery::of())
->map(DecodeForm::of())
->match(
static fn($request) => $request,
static fn() => throw new \RuntimeException,
);
$request instanceof ServerRequest, // true