NAME
Gantry::Engine::MP13 - mod_perl 1.0 plugin ( or mixin )
SYNOPSIS
use Gantry::Engine::MP13;
DESCRIPTION
This module is the binding between the Gantry framework and the mod_perl API. This particluar module contains the mod_perl 1.0 specific bindings.
See mod_perl documentation for a more detailed description for some of these bindings.
METHODS
- $self->apache_param_hash
-
Return a hash reference to the apache request body parameters.
- $self->apache_request
-
Apache::Request is a subclass of the Apache class, which adds methods for parsing GET requests and POST requests where Content-type is one of application/x-www-form-urlencoded or multipart/form-data. See the libapreq(3) manpage for more details.
- $self->base_server
-
Returns the physical server this connection came in on (main server or vhost):
- dispatch_location
-
The uri tail specific to this request. Returns:
$self->uri, $self->location
Note that this is a two element list.
- $self->engine
-
Returns the name of the engine, i.e. Gantry::Engine::MP13
- $self->engine_init
-
Receives the request object and stores it in the site object. Returns nothing useful.
- $self->err_header_out
-
The $r->err_headers_out method will return a %hash of server response headers. This can be used to initialize a perl hash, or one could use the $r->err_header_out() method (described below) to retrieve or set a specific header value directly
See mod_perl docs.
- fish_conf
-
Pass this method the name of a conf parameter you need. Returns the value for the parameter.
- fish_location
-
Returns the location for the current request.
- fish_method
-
Returns the HTTP method of the current request.
- fish_path_info
-
Returns the path info for the current request.
- fish_uri
-
Returns the uri for the current request.
- fish_user
-
Returns the currently logged-in user.
- $self->get_arg_hash
-
returns a hash of url arguments. /some/where?arg1=don&arg2=johnson
- $self->get_auth_dbh
-
Same as get_dbh, but for the authentication database.
- get_config
-
If you are using Gantry::Conf, this will return the config hash reference for the current location.
- get_cached_conf/set_cached_conf
-
These cache the Gantry::Conf config hash in pnotes. Override them if you want more persistent caching. These are instance methods. get receives the invoking object, the name of the GantryConfInstance, and the current location (for ease of use, its also in the invocant). set receives those plus the conf hash it should cache.
- $self->get_dbh
-
Returns the current regular database connection if one is available or undef otherwise.
- $self->header_in
-
The $r->headers_in method will return a %hash of client request headers. This can be used to initialize a perl hash, or one could use the $r->header_in() method (described below) to retrieve a specific header value directly.
See mod_perl docs.
- $self->header_out( $r, $header_key, $header_value )
-
Change the value of a response header, or create a new one.
- $self->port
-
Returns port number in which the request came in on.
- $self->print_output( $response_page )
-
This method sends the contents of $response page back to apache. It uses the print method on the request object.
- $self->remote_ip
-
Returns the IP address for the remote user
- $self->send_http_header( $r )
-
Send the response line and all headers to the client. Takes an optional parameter indicating the content-type of the response, i.e. 'text/html'.
This method will create headers from the $r->content_xxx() and $r->no_cache() attributes (described below) and then append the headers defined by $r->header_out (or $r->err_header_out if status indicates an error).
See mod_perl 1.0 docs.
- $self->server_root
-
Returns the value set by the top-level ServerRoot directive
- $self->set_content_type()
-
Sets the content type stored in the site object's content_type attribute on the apache request object.
- $self->set_no_cache
-
Sets the no_cache flag in the apache request object with the value for no_cache in the site object.
- set_req_params
-
Sets up the apreq object and the form parameters from it.
- $self->status_const( 'OK | DECLINED | REDIRECT' )
-
Get or set the reply status for the client request. The Apache::Constants module provide mnemonic names for the status codes.
SEE ALSO
mod_perl(3), Gantry(3)
LIMITATIONS
AUTHOR
Tim Keefer <tkeefer@gmail.com>
COPYRIGHT and LICENSE
Copyright (c) 2005-6, Tim Keefer.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.
1 POD Error
The following errors were encountered while parsing the POD:
- Around line 647:
You forgot a '=back' before '=head1'