plack::middleware::deflater(3pm) [debian man page]

Plack::Middleware::Deflater(3pm)			User Contributed Perl Documentation			  Plack::Middleware::Deflater(3pm)

NAME

       Plack::Middleware::Deflater - Compress response body with Gzip or Deflate

SYNOPSIS

	 use Plack::Builder;

	 builder {
	   enable sub {
	       my $app = shift;
	       sub {
		   my $env = shift;
		   my $ua = $env->{HTTP_USER_AGENT} || '';
		   # Netscape has some problem
		   $env->{"psgix.compress-only-text/html"} = 1 if $ua =~ m!^Mozilla/4!;
		   # Netscape 4.06-4.08 have some more problems
		    $env->{"psgix.no-compress"} = 1 if $ua =~ m!^Mozilla/4.0[678]!;
		   # MSIE (7|8) masquerades as Netscape, but it is fine
		   if ( $ua =~ m!MSIE (?:7|8)! ) {
		       $env->{"psgix.no-compress"} = 0;
		       $env->{"psgix.compress-only-text/html"} = 0;
		   }
		   $app->($env);
	       }
	   };
	   enable "Deflater",
	       content_type => ['text/css','text/html','text/javascript','application/javascript'],
	       vary_user_agent => 1;
	   sub { [200,['Content-Type','text/html'],["OK"]] }
	 };

DESCRIPTION

       Plack::Middleware::Deflater is a middleware to encode your response body in gzip or deflate, based on "Accept-Encoding" HTTP request
       header. It would save the bandwidth a little bit but should increase the Plack server load, so ideally you should handle this on the
       frontend reverse proxy servers.

       This middleware removes "Content-Length" and streams encoded content, which means the server should support HTTP/1.1 chunked response or
       downgrade to HTTP/1.0 and closes the connection.

CONFIGURATIONS

       content_type
	     content_type => 'text/html',
	     content_type => [ 'text/html', 'text/css', 'text/javascript', 'application/javascript', 'application/x-javascript' ]

	   Content-Type header to apply deflater. if content-type is not defined, Deflater will try to deflate all contents.

       vary_user_agent
	     vary_user_agent => 1

	   Add "User-Agent" to Vary header.

ENVIRONMENT VALUE

       psgix.no-compress
	   Do not apply deflater

       psgix.compress-only-text/html
	   Apply deflater only if content_type is "text/html"

LICENSE

       This software is licensed under the same terms as Perl itself.

AUTHOR

       Tatsuhiko Miyagawa

SEE ALSO

       Plack, <http://httpd.apache.org/docs/2.2/en/mod/mod_deflate.html>

perl v5.14.2							    2012-06-18					  Plack::Middleware::Deflater(3pm)

Plack::Response(3pm)					User Contributed Perl Documentation				      Plack::Response(3pm)

NAME

       Plack::Response - Portable HTTP Response object for PSGI response

SYNOPSIS

	 use Plack::Response;

	 sub psgi_handler {
	     my $env = shift;

	     my $res = Plack::Response->new(200);
	     $res->content_type('text/html');
	     $res->body("Hello World");

	     return $res->finalize;
	 }

DESCRIPTION

       Plack::Response allows you a way to create PSGI response array ref through a simple API.

METHODS

       new
	     $res = Plack::Response->new;
	     $res = Plack::Response->new($status);
	     $res = Plack::Response->new($status, $headers);
	     $res = Plack::Response->new($status, $headers, $body);

	   Creates a new Plack::Response object.

       status
	     $res->status(200);
	     $status = $res->status;

	   Sets and gets HTTP status code. "code" is an alias.

       headers
	     $headers = $res->headers;
	     $res->headers([ 'Content-Type' => 'text/html' ]);
	     $res->headers({ 'Content-Type' => 'text/html' });
	     $res->headers( HTTP::Headers->new );

	   Sets and gets HTTP headers of the response. Setter can take either an array ref, a hash ref or HTTP::Headers object containing a list
	   of headers.

       body
	     $res->body($body_str);
	     $res->body([ "Hello", "World" ]);
	     $res->body($io);

	   Gets and sets HTTP response body. Setter can take either a string, an array ref, or an IO::Handle-like object. "content" is an alias.

	   Note that this method doesn't automatically set Content-Length for the response. You have to set it manually if you want, with the
	   "content_length" method (see below).

       header
	     $res->header('X-Foo' => 'bar');
	     my $val = $res->header('X-Foo');

	   Shortcut for "$res->headers->header".

       content_type, content_length, content_encoding
	     $res->content_type('text/plain');
	     $res->content_length(123);
	     $res->content_encoding('gzip');

	   Shortcut for the equivalent get/set methods in "$res->headers".

       redirect
	     $res->redirect($url);
	     $res->redirect($url, 301);

	   Sets redirect URL with an optional status code, which defaults to 302.

	   Note that this method doesn't normalize the given URI string. Users of this module have to be responsible about properly encoding URI
	   paths and parameters.

       location
	   Gets and sets "Location" header.

	   Note that this method doesn't normalize the given URI string in the setter. See above in "redirect" for details.

       cookies
	     $res->cookies->{foo} = 123;
	     $res->cookies->{foo} = { value => '123' };

	   Returns a hash reference containing cookies to be set in the response. The keys of the hash are the cookies' names, and their
	   corresponding values are a plain string (for "value" with everything else defaults) or a hash reference that can contain keys such as
	   "value", "domain", "expires", "path", "httponly", "secure".

	   "expires" can take a string or an integer (as an epoch time) and does not convert string formats such as "+3M".

	     $res->cookies->{foo} = {
		 value => 'test',
		 path  => "/",
		 domain => '.example.com',
		 expires => time + 24 * 60 * 60,
	     };

       finalize
	     $res->finalize;

	   Returns the status code, headers, and body of this response as a PSGI response array reference.

AUTHOR

       Tokuhiro Matsuno

       Tatsuhiko Miyagawa

SEE ALSO

       Plack::Request

perl v5.14.2							    2012-06-21						      Plack::Response(3pm)