NAME
Protocol::HTTP2 - HTTP/2 protocol (draft 15) implementation
SYNOPSIS
use Protocol::HTTP2;
# get current draft version
print $Protocol::HTTP2::draft; # 15
# get protocol identification string for secure connections
print Protocol::HTTP2::ident_tls; # h2-15
# get protocol identification string for non-secure connections
print Protocol::HTTP2::ident_plain; # h2c-15DESCRIPTION
Protocol::HTTP2 is HTTP/2 protocol (draft 15) implementation with stateful decoders/encoders of HTTP/2 frames. You may use this module to implement your own HTTP/2 client/server/intermediate on top of your favorite event loop over plain or tls socket (see examples).
STATUS
Current status - alpha. Structures, module names and methods may change vastly. I've started this project to understand internals of HTTP/2 and may be it will never become production or even finished.
| Spec | status |
| ----------------------- | --------------- |
| Negotiation | ALPN, NPN, |
| | Upgrade, direct |
| Preface | + |
| Headers (de)compression | + |
| Stream states | + |
| Flow control | ± |
| Stream priority | ± |
| Server push | + |
| Connect method | - |
| Frame | encoder | decoder |
| --------------- |:-------:|:-------:|
| DATA | ± | + |
| HEADERS | + | + |
| PRIORITY | + | + |
| RST_STREAM | + | + |
| SETTINGS | + | + |
| PUSH_PROMISE | + | + |
| PING | + | + |
| GOAWAY | + | + |
| WINDOW_UPDATE | + | + |
| CONTINUATION | ± | + |MODULES
Protocol::HTTP2::Client
Client protocol decoder/encoder with constructor of requests
Protocol::HTTP2::Server
Server protocol decoder/encoder with constructor of responses/pushes
Protocol::HTTP2::Connection
Main low level module for protocol logic and state processing. Connection object is a mixin of Protocol::HTTP2::Frame (frame encoding/decoding), Protocol::HTTP2::Stream (stream operations) and Protocol::HTTP2::Upgrade (HTTP/1.1 Upgrade support)
Protocol::HTTP2::HeaderCompression
Module implements HPACK (draft 09) - Header Compression for HTTP/2. http://tools.ietf.org/html/draft-ietf-httpbis-header-compression-09
Protocol::HTTP2::Constants
Module contain all defined in HTTP/2 protocol constants and default values
Protocol::HTTP2::Trace
Module for debugging. (Ab)used Log::Dispatch internally, may be removed soon.
SEE ALSO
http://http2.github.io/ - official HTTP/2 specification site
http://daniel.haxx.se/http2/ - http2 explained
LICENSE
Copyright (C) Vladimir Lettiev.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
AUTHOR
Vladimir Lettiev <thecrux@gmail.com>