NAME

Apache2::SetOptions - Set Apache Options from Perl

SYNOPSIS

  use Apache2::RequestRec;
  use Apache2::SetOptions;
  use Apache2::Const -compile=>':options';

  $r->set_allow_options( Apache2::Const::OPT_EXECCGI |
                         Apache2::Const::OPT_INDEXES );

  $r->clear_allow_options( Apache2::Const::OPT_EXECCGI |
                           Apache2::Const::OPT_INDEXES );

  @list=$r->allow_options_as_strings( Apache2::Const::OPT_EXECCGI |
                                      Apache2::Const::OPT_INDEXES );

  ($opts, $err)=$r->allow_options_from_strings( qw{All
                                                   SymLinksIfOwnerMatch
                                                   MultiView} );

DESCRIPTION

This module adds a few methods to Apache2::RequestRec class to work with Apache's Options.

METHODS

$r->set_allow_options( $opts )

$r->clear_allow_options( $opts )

These 2 methods set or clear Options in the current $r->per_dir_config. Remember that $r->per_dir_config is reset after the Uri Translation Phase. Thus, these methods are not useful in an PerlPostReadRequestHandler or a PerlTransHandler.

When called from a PerlMapToStorageHandler options set this way may be overridden in later phases since after this phase <Directory>, <Files> and <Location> sections are merged.

Options set the Header Parser Phase or later are valid until the end of the request cycle.

@strings=$r->allow_options_as_strings( $opts )

@strings=Apache2::SetOptions->allow_options_as_strings( $opts )

convert an Options value into human readable strings.

($opts, $err)=$r->allow_options_from_strings( @words )

($opts, $err)=Apache2::SetOptions->allow_options_from_strings( @words )

convert strings into an Options value. The 2nd return value is an ARRAY reference containing words that aren't known options.

EXPORT

nothing

SEE ALSO

mod_perl2

AUTHOR

Torsten Foertsch, <torsten.foertsch@gmx.net>

SPONSORING

Sincere thanks to Arvato Direct Services (http://www.arvato.com/) for sponsoring this module.

COPYRIGHT AND LICENSE

Copyright (C) 2005 by Torsten Foertsch

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.