Perl Documentation

NAME

uri_to_file - Convert URIs to filenames, and other critical stuff

SYNOPSIS

Plugin uri_to_file

# optionally:
DirectoryIndex index.html

DESCRIPTION

This plugin provides the filename for a given URI. It is absolutely required that you load this plugin if you wish to serve files off the filesystem, or else re-implement its functionality somehow.

It also sets path_info in the headers object, provides a redirect when a directory without a "/" is requested, and implements DirectoryIndex (see below).

Note that $hd->filename will be a bytestring corresponding to the exact byte sequence sent in the URI, thus non-UTF-8 filenames should "just work".

CONFIG

DirectoryIndex STRING

A filename to append to directory requests. If the file exists then it will be the filename used instead of the directory itself.