GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PLACK::RESPONSE (3)

.ds Aq ’

NAME

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

CONTENTS

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::Fast->new );



Sets and gets HTTP headers of the response. Setter can take either an array ref, a hash ref or HTTP::Headers::Fast 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, max-age.

expires can take a string or an integer (as an epoch time) and <B>does notB> 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.

to_app


  $app = $res->to_app;



A helper shortcut for sub { $res->finalize }.

AUTHOR

Tokuhiro Matsuno

Tatsuhiko Miyagawa

SEE ALSO

Plack::Request
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 PLACK::RESPONSE (3) 2015-06-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.