NAME
Plack::Handler::Hyperman - Plack/PSGI adapter for the Hyperman server
SYNOPSIS
plackup -s Hyperman --port 8080 --workers 6 app.psgi
DESCRIPTION
Lets any Plack application run on Hyperman, the kqueue event-loop PSGI server. Options: host, port, and workers (alias max_workers), plus listen for binding several listeners (for example plain :80 beside TLS :443) in one server - see "Multiple listeners" in Hyperman.
Every other Hyperman->run option is passed through when given and left alone when not, so a server started by plackup behaves identically to the same options passed to run directly: reuseport, completion, max_requests_per_worker, shutdown_grace, affinity, idle_timeout, header_timeout, max_pipeline, http2, http3, http3_max_conns, redirect_https, max_body, access_log, deny, deny_capacity, rate_capacity, bus_slots, bus_slot_size, bus_groups, arena_name, arena_size, compress, compress_min_length, compress_level, and the tls_* family. See "run" in Hyperman for what each means; the two that most often want setting have their own sections below.
deny takes an arrayref, and a single --deny 1.2.3.4 on a command line arrives as a plain scalar, so one address is accepted as readily as several.
max_body
The largest request Hyperman will buffer, headers plus body, before the application is called. Over it, the request is answered 413 Payload Too Large. The default is 16MB.
plackup -s Hyperman --max_body 67108864 # 64MB, for large uploads
plackup -s Hyperman --max_body 262144 # 256KB, for a JSON API
Compression
Response compression is off by default, as it is under Hyperman->run, and is turned on per server:
plackup -s Hyperman --compress 1
plackup -s Hyperman --compress 1 --compress_min_length 512
plackup -s Hyperman --compress 1 --compress_level 6
A response is compressed only if the client accepted gzip, it carries no Content-Encoding of its own, its media type is on the compressible allowlist, and it is at least compress_min_length bytes. On a Hyperman built without zlib the option is accepted and inert. See "Response compression" in Hyperman for the full contract, including the Content-Encoding: identity opt-out and the ETag rewrite.
METHODS
new
my $handler = Plack::Handler::Hyperman->new(%options);
Takes the options plackup collected, the --port, --workers and every Hyperman->run option named above, and keeps them for run.
run
$handler->run($app);
Starts Hyperman on the PSGI application with the options given to new. The listen specs are parsed (host:port, [v6]:port, a bare port or a socket path), the aliases other servers use for the TLS files are honoured, and an option Hyperman does not take is warned about rather than dropped. Does not return until the server stops.
SEE ALSO
AUTHOR
LNATION <email@lnation.org>
LICENSE AND COPYRIGHT
This software is Copyright (c) 2026 by LNATION. This is free software, licensed under the Artistic License 2.0.