Apache-Stage

 view release on metacpan or  search on metacpan

README  view on Meta::CPAN

NAME
    Apache::Stage - Manage A Staging Directory

SYNOPSIS
      <Location /STAGE>
        # this location is served by normal apache. It's recommended to
        # restrict access to this location to registered authors of this
        # site, but a restriction isn't necessary
        ErrorDocument 403 /stage-redir
        ErrorDocument 404 /stage-redir
      </Location>

      <Location /stage-redir>
        # the name of this location must match the ErrorDocument redirects
        # above

        # PerlSetVar apache_stage_regex " ^ (/STAGE/[^/]*) (.*) $ "

        # This regex has to split a staged URI into two parts. It is
        # evaluated with the /ox switch in effect, so this will NOT be a

README  view on Meta::CPAN

                                             necessary

     /STAGE/u6             -                 Fails unless location exists

    The entries described in SYNOPSIS in the access.conf or an equivalent
    place define the name of the staging directory, the name of an internal
    location that catches the exception when a document is not in the
    staging directory, and the regular expression that transforms the
    staging URI into the corresponding public URI.

    With this setup only ErrorDocument 403 and 404 will be served by
    Apache::Stage. If you need coexistence with different ErrorDocument
    handlers, you will either have to disable them for /STAGE or integrate
    the code of Apache::Stage into an if/else branch based on the path.

HISTORY
    This module has not changed since 1997.

AUTHOR
    andreas.koenig@anima.de

Stage.pm  view on Meta::CPAN

Apache::Stage - Manage A Staging Directory

=head1 SYNOPSIS

  <Location /STAGE>
    # this location is served by normal apache. It's recommended to
    # restrict access to this location to registered authors of this
    # site, but a restriction isn't necessary
    ErrorDocument 403 /stage-redir
    ErrorDocument 404 /stage-redir
  </Location>

  <Location /stage-redir>
    # the name of this location must match the ErrorDocument redirects
    # above

    # PerlSetVar apache_stage_regex " ^ (/STAGE/[^/]*) (.*) $ "

    # This regex has to split a staged URI into two parts. It is
    # evaluated with the /ox switch in effect, so this will NOT be a

Stage.pm  view on Meta::CPAN

                                         necessary

 /STAGE/u6             -                 Fails unless location exists

The entries described in SYNOPSIS in the access.conf or an equivalent
place define the name of the staging directory, the name of an
internal location that catches the exception when a document is not in
the staging directory, and the regular expression that transforms the
staging URI into the corresponding public URI.

With this setup only ErrorDocument 403 and 404 will be served by
Apache::Stage. If you need coexistence with different ErrorDocument
handlers, you will either have to disable them for /STAGE or integrate
the code of Apache::Stage into an if/else branch based on the path.

=head1 HISTORY

This module has not changed since 1997.

=head1 AUTHOR