jifty::view::static::handler(3pm) [debian man page]

Jifty::View::Static::Handler(3pm)			User Contributed Perl Documentation			 Jifty::View::Static::Handler(3pm)

NAME

       Jifty::View::Static::Handler - Jifty view handler for static files

DESCRIPTION

       This is deprecated and is being port to a stack of plack middleware and plack::app::file

       This class takes care of serving out static files for a Jifty application.

       When fully operational, it will use an algorithm along the lines of the following:

       * Static files are served out of a separate root * If static files go through apache:
	   * How do we merge together the N static roots?  * If static files go through Jifty::Handler
	   * We need a flag to allow them to go through the dispatcher, too
	   * return "True" (304) for if-modified-since
	   * if the browser accepts gzipped data,
	       see if we have a cached gzipped copy
		   if so, send it
	       see if we have a marker indicating that gzip is a lose
		   if so, send uncompressed

	       gzip the content
	       send the gzipped content
	    * if the browser doesn't accept gzipped content
	       send the content uncompressed

   new
       Create a new static file handler. Likely, only the "Jifty::Handler" needs to do this.

   roots
       Returns all the static roots the handler will search

   show $path
       Handle a request for $path. If we can't find a static file of that name, return undef.

   handle_request $path
       An alias for "show"

   file_path $path
       Returns the system path for $path, searching inside the application's static root, loaded plugins' static roots, and finally Jifty's static
       root.  Returns undef if it can't find the file in any path.

   template_exists $path
       An alias for "file_path".

   mime_type $path
       Returns the mime type of the file whose path on disk is $path. Tries to use MIME::Types to guess first. If that fails, it falls back to
       "File::MMagic".

   send_file $path $mimetype
       Print $path to STDOUT (the client), identified with a mimetype of $mimetype.

   send_http_header [COMPRESSION, LENGTH, LAST_MODIFIED]
       Sends appropriate cache control and expiration headers such that the client will cache the content.  COMPRESSION is deprecated

   send_not_modified
       Sends a "304 Not modified" response to the browser, telling it to use a cached copy.

perl v5.14.2							    2010-09-25					 Jifty::View::Static::Handler(3pm)

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

NAME

       Plack::Middleware::Static - serve static files with Plack

SYNOPSIS

	 use Plack::Builder;

	 builder {
	     enable "Plack::Middleware::Static",
		 path => qr{^/(images|js|css)/}, root => './htdocs/';
	     $app;
	 };

DESCRIPTION

       Enable this middleware to allow your Plack-based application to serve static files.

       If the given request matches with the pattern defined in "path", this middleware will try to locate the file in "root". If the file exists
       it will be served but otherwise 404 response will be returned. See "pass_through" option below to change this behavior.

       If the requested document is not within the "root" (i.e. directory traversal) or the file is there but not readable, a 403 Forbidden
       response will be returned.

       The content type returned will be determined from the file extension based on Plack::MIME.

CONFIGURATIONS

       path, root
	     enable "Plack::Middleware::Static",
		 path => qr{^/static/}, root => 'htdocs/';

	   "path" specifies the URL pattern (regular expression) or a callback to match with requests to serve static files for. "root" specifies
	   the root directory to serve those static files from. The default value of "root" is the current directory.

	   This examples configuration serves "/static/foo.jpg" from "htdocs/static/foo.jpg". Note that the matched "/static/" portion is still
	   appears in the local mapped path. If you don't like it, use a callback instead to munge $_:

	     enable "Plack::Middleware::Static",
		 path => sub { s!^/static/!! }, root => 'static-files/';

	   This configuration would serve "/static/foo.png" from "static-files/foo.png" (not "static-files/static/foo.png"). The callback
	   specified in "path" option matches against $_ and then updates the value since it does s///, and returns the number of matches, so it
	   will pass through when "/static/" doesn't match.

	   If you want to map multiple static directories from different root, simply add "this", middleware multiple times with different
	   configuration options.

       pass_through
	   By turning on this option, this middleware will pass the request back to the application for further processing, if the incoming
	   request path matches with the "path" but the requested file is not found on the file system.

AUTHOR

       Tokuhiro Matsuno, Tatsuhiko Miyagawa

SEE ALSO

       Plack::Middleware Plack::Builder

perl v5.14.2							    2011-06-22					    Plack::Middleware::Static(3pm)