![]() |
Home / Documentation / 2.0 / API / | ![]() |
||
![]() ![]() ![]() |
||||
Apache::SubRequest - Perl API for Apache subrequests | ||||
![]() ![]() |
|
||
DESTROY
META: Autogenerated - needs to be reviewed/completed
Free the memory associated with a sub request
$r->DESTROY();
$r
(Apache::RequestRec
)
The sub request to finish
internal_fast_redirect
META: Autogenerated - needs to be reviewed/completed
Redirect the current request to a sub_req, merging the pools
$r->internal_fast_redirect($sub_req);
$r
(Apache::RequestRec
)
The current request
$sub_req
(string)
A subrequest created from this request
internal_redirect
META: Autogenerated - needs to be reviewed/completed
Then there's the case that you want some other request to be served as the top-level request INSTEAD of what the client requested directly. If so, call this from a handler, and then immediately return OK.
Redirect the current request to some other uri
$r->internal_redirect($new_uri);
$r
(Apache::RequestRec
)
The current request
$new_uri
(string)
The URI to replace the current request with
internal_redirect_handler
META: Autogenerated - needs to be reviewed/completed
This function is designed for things like actions or CGI scripts, when using AddHandler, and you want to preserve the content type across an internal redirect.
$r->internal_redirect_handler($new_uri);
$r
(Apache::RequestRec
)
The current request
$new_uri
(string)
The URI to replace the current request with.
lookup_dirent
META: Autogenerated - needs to be reviewed/completed
Create a sub request for the given apr_dir_read result. This sub request can be inspected to find information about the requested file
$lr = $r->lookup_dirent($finfo, $subtype, $next_filter);
$r
(Apache::RequestRec
)
The current request
$finfo
(APR::Finfo
)
The apr_dir_read result to lookup
$subtype
(integer)
What type of subrequest to perform, one of;
Apache::SUBREQ_NO_ARGS ignore r->args and r->path_info Apache::SUBREQ_MERGE_ARGS merge r->args and r->path_info
$next_filter
(integer)
The first filter the sub_request should use. If this is NULL, it defaults to the first filter for the main request
$lr
(Apache::RequestRec
)
The new request record
lookup_file
META: Autogenerated - needs to be reviewed/completed
Create a sub request for the given file. This sub request can be inspected to find information about the requested file
$ret = $r->lookup_file($new_file, $next_filter);
$r
(Apache::RequestRec
)
The current request
$new_file
(string)
The URI to lookup
$next_filter
(Apache::Filter
)
The first filter the sub_request should use. If this is NULL, it defaults to the first filter for the main request
$ret
(Apache::SubRequest
)
The new request record
lookup_uri
META: Autogenerated - needs to be reviewed/completed
Create a sub request from the given URI. This sub request can be inspected to find information about the requested URI.
$ret = $r->lookup_uri($new_file, $next_filter);
$r
(Apache::RequestRec
)
The current request
$new_file
(string)
The URI to lookup
$next_filter
(Apache::Filter
)
The first filter the sub_request should use. If this is NULL, it defaults to the first filter for the main request
$ret
(Apache::SubRequest
)
The new request record
lookup_method_uri
META: Autogenerated - needs to be reviewed/completed
Create a sub request for the given URI using a specific method. This sub request can be inspected to find information about the requested URI
$ret = $r->lookup_method_uri($method, $new_file, $next_filter);
$r
(Apache::RequestRec
)
The current request
$method
(string)
The method to use in the new sub request
$new_file
(string)
The URI to lookup
$next_filter
(Apache::Filter
)
The first filter the sub_request should use. If this is NULL, it defaults to the first filter for the main request
$ret
(Apache::SubRequest
)
The new request record
mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 1.1.
|
![]() |
![]() ![]() ![]() |