Plack::Middleware::XSendfile - Sets X-Sendfile (or a like) header for frontends


  enable "Plack::Middleware::XSendfile";


When the body is a blessed reference with a path method, then the return value of that method is used to set the X-Sendfile header.

The body is set to an empty list, and the Content-Length header is set to 0.

If the X-Sendfile header is already set, then the body and Content-Length will be untouched.

You should use IO::File::WithPath or Plack::Util's set_io_path to add path method to an IO object in the body.

See for the frontend configuration.

Plack::Middleware::XSendfile does not set the Content-Type header.



The header tag to use. If unset, the environment key plack.xsendfile.type will be used, then the HTTP_X_SENDFILE_TYPE header.

Supported values are:

  • X-Accel-Redirect

  • X-Lighttpd-Send-File

  • X-Sendfile.

An unsupport value will log an error.


Tatsuhiko Miyagawa