brian d foy > Apache-Htaccess-1.4 > Apache::Htaccess

Download:
Apache-Htaccess-1.4.tar.gz

Dependencies

Annotate this POD

Related Modules

CGI::Session
more...
By perlmonks.org

CPAN RT

Open  0
View/Report Bugs
Module Version: 1.4   Source  

NAME ^

Apache::Htaccess - Create and modify Apache .htaccess files

SYNOPSIS ^

        use Apache::Htaccess;

        my $obj = Apache::Htaccess->new("htaccess");
        die($Apache::Htaccess::ERROR) if $Apache::Htaccess::ERROR;

        $obj->global_requires(@groups);

        $obj->add_global_require(@groups);

        $obj->directives(CheckSpelling => 'on');

        $obj->add_directive(CheckSpelling => 'on');
        
        $obj->requires('admin.cgi',@groups);

        $obj->add_require('admin.cgi',@groups);

        $obj->save();
        die($Apache::Htaccess::ERROR) if $Apache::Htaccess::ERROR;

DESCRIPTION ^

This module provides an object-oriented interface to Apache .htaccess files. Currently the ability exists to read and write simple htaccess files.

METHODS ^

new()

        my $obj = Apache::Htaccess->new($path_to_htaccess);

Creates a new Htaccess object either with data loaded from an existing htaccess file or from scratch

save()

        $obj->save();

Saves the htaccess file to the filename designated at object creation. This method is automatically called on object destruction.

global_requires()

        $obj->global_requires(@groups);

Sets the global group requirements. If no params are provided, will return a list of the current groups listed in the global require. Note: as of 0.3, passing this method a parameter list causes the global requires list to be overwritten with your parameters. see add_global_require().

add_global_require()

        $obj->add_global_require(@groups);

Sets a global require (or requires) nondestructively. Use this if you just want to add a few global requires without messing with all of the global requires entries.

requires()

        $obj->requires($file,@groups);

Sets a group requirement for a file. If no params are given, returns a list of the current groups listed in the files require directive. Note: as of 0.3, passing this method a parameter list causes the requires list to be overwritten with your parameters. see add_require().

add_require()

        $obj->add_require($file,@groups);

Sets a require (or requires) nondestructively. Use this if you just want to add a few requires without messing with all of the requires entries.

directives()

        $obj->directives(CheckSpelling => 'on');

Sets misc directives not directly supported by the API. If no params are given, returns a list of current directives and their values. Note: as of 0.2, passing this method a parameter list causes the directive list to be overwritten with your parameters. see add_directive().

add_directive()

        $obj->add_directive(CheckSpelling => 'on');

Sets a directive (or directives) nondestructively. Use this if you just want to add a few directives without messing with all of the directive entries.

TO DO ^

* rewrite the parser to handle blocks

AUTHOR ^

Matt Cashner <matt@cre8tivegroup.com> originally created this module, and brian d foy <bdfoy@cpan.org> currently maintains it.

COPYRIGHT ^

Copyright (C) 2000 by The Creative Group.

This module may be distributed under the terms of Perl itself.

syntax highlighting: