NAME

Konstrukt::Handler::Apache - Handler for an Apache request

SYNOPSIS

Handle an apache request

Konstrukt::Handler::Apache::handler($request);

Plugins and other module may access some request-specific data:

#the absolute path to the processed file
$Konstrukt::Handler->{abs_filename}

#the path to the processed file relative to the document root
$Konstrukt::Handler->{filename}

#the apache request object. shouldn't be used for compatibility reasons.
$Konstrukt::Handler->{apache_request}

#the environment variables of this process as an hashref
$Konstrukt::Handler->{ENV}

#cookies as an hashref of cookie objects
$Konstrukt::Handler->{cookies}
#create new cookie:
$Konstrukt::Handler->{foo} = CGI::Cookie->new(-name => 'foo', -value => 'bar');

DESCRIPTION

Parses the requested file against special (e.g. <&...&>) tags.

CONFIGURATION

Tell Apache to apply the PerlHandler on the requested files.

#You may load a startup script that loads all the modules at startup
#PerlRequire  perl-scripts/script_to_load_at_startup.pl

#mod_perl 1
<IfDefine !MODPERL2>
	PerlWarn On
	PerlFreshRestart On
</IfDefine>

#mod_perl 2
<IfDefine MODPERL2>
	#Some useful options
	PerlSwitches -w #mod_perl 2
	
	#Monitor and reload all modules in %INC:
	#httpd.conf:
	PerlModule Apache2::Reload
	PerlInitHandler Apache2::Reload
	
	#Alternatively: Reload a specific set of modules only
	PerlModule Apache2::Reload
	PerlInitHandler Apache2::Reload
	PerlSetVar ReloadAll Off
	#Then any modules with the line:
	# use Apache2::Reload;
	#Will be reloaded when they change.
	#You can also sepcify the modules to be reloaded manually
	PerlSetVar ReloadModules "My::Foo My::Bar Foo::Bar::Test"
	PerlSetVar ReloadDirectories "/tmp/project1 /tmp/project2"
	#Note that ReloadModules and ReloadDirectories will narrow down the set
	#of modules to reload.
	#To monitor the reloading of modules use:
	PerlSetVar ReloadDebug On
</IfDefine>

#Preload Module
PerlModule Konstrukt
PerlModule Konstrukt::Handler::Apache

#You may also assign the handler to *.html
<Files *.ihtml>
	<IfDefine !MODPERL2>
		SetHandler  perl-script
	</IfDefine>
	<IfDefine MODPERL2>
		SetHandler  modperl
	</IfDefine>
	PerlHandler Konstrukt::Handler::Apache
</Files>

#Do not allow access to *.template, *.form and konstrukt.settings files
#as they contain sensitive information
<FilesMatch "(\.template|\.form|konstrukt\.settings)$">
	Deny from All
</FilesMatch>

FUNCTIONS

handler

Handles the request.

Filter a file before returning it to the web client.

Parameters:

• $request - The Apache request

AUTHOR

Copyright 2006 Thomas Wittek (mail at gedankenkonstrukt dot de). All rights reserved.

This document is free software. It is distributed under the same terms as Perl itself.

SEE ALSO

Konstrukt::Handler, Konstrukt