request

List of predefined variables within Extenso.

REQUEST

NAME

request - List of predefined variables available within Extenso.

SYNOPSIS

request()

DESCRIPTION

Extenso defined a set of predefined variables or functions returning these.

sn_binversion contains the current version of the binary file. sn_version contains the current version of sncode.

REQUEST()

The variables described in this section can be set or get. They are from the request_rec structure of apache.

The function can also be called with 2 arguments: request(key,value) where key is one of the following entry in request_rec.

the_request : string
First line of request.
 
scheme : string
returns http or https depending on the request. Since version 5.68
proxyreq : integer
A proxy request (calculated during post_read_request/translate_name) possible values PROXYREQ_NONE, PROXYREQ_PROXY, PROXYREQ_REVERSE, PROXYREQ_RESPONSE.
header_only : integer
HEAD request, as opposed to GET.
protocol : string
Protocol string, as given to us, or HTTP/0.9.
proto_num : integer
Protocol version number of protocol; 1.1 = 1001.
hostname : string
Host, as set by full URI or Host:
request_time : string
Time when the request started. The returned variable is a context that defines all the variables in the date function.
To set the request time, you can pass the time in the following format:
  • YYYY-MM-DD HH:MM:SS
  • RFC 822 date
  • Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123
  • Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
  • Sun Nov 6 08:49:37 1994 ; ANSI C’s asctime() format
  • Sun, 6 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123
  • Sun, 06 Nov 94 08:49:37 GMT ; RFC 822
  • Sun, 6 Nov 94 08:49:37 GMT ; RFC 822
  • Sun, 06 Nov 94 08:49 GMT ; Unknown [drtr@ast.cam.ac.uk]
  • Sun, 6 Nov 94 08:49 GMT ; Unknown [drtr@ast.cam.ac.uk]
  • Sun, 06 Nov 94 8:49:37 GMT ; Unknown [Elm 70.85]
  • Sun, 6 Nov 94 8:49:37 GMT ; Unknown [Elm 70.85]
  • status_line : string

Status line, if set by script.

status : int
Status line.

Definition at line 918 of file httpd.h.

method : String
Request method (eg. GET, HEAD, POST, etc.) Definition at line 925 of file httpd.h.
method_number : int
M_GET, M_POST, etc.
apr_int64_t request_rec::allowed not implemented
allowed is a bitvector of the allowed methods.
A handler must ensure that the request method is one that it is capable of handling. Generally modules should DECLINE any request methods they do not handle. Prior to aborting the handler like this the handler should set r→allowed to the list of methods that it is willing to handle. This bitvector is used to construct the "Allow:" header required for OPTIONS requests, and HTTP_METHOD_NOT_ALLOWED and HTTP_NOT_IMPLEMENTED status codes.
Since the default_handler deals with OPTIONS, all modules can usually decline to deal with OPTIONS. TRACE is always allowed, modules don’t need to set it explicitly.
Since the default_handler will always handle a GET, a module which does not implement GET should probably return HTTP_METHOD_NOT_ALLOWED. Unfortunately this means that a Script GET handler can’t be installed by mod_actions. Definition at line 949 of file httpd.h.
apr_array_header_t* request_rec::allowed_xmethods not implemented
ap_method_list_t* request_rec::allowed_methods not implemented
List of allowed methods.
apr_off_t request_rec::sent_bodyct
byte count in stream is for body
apr_off_t request_rec::bytes_sent
body byte count, for easy access
mtime : associative array
Last modified time of the requested resource.
chunked : integer
sending chunked transfer-coding
Definition at line 965 of file httpd.h.
range : string
The Range: header.
clength : integer
The "real" content length.
remaining : integer
Remaining bytes left to read from the request body.
read_length : integer
Number of bytes that have been read from the request body.
read_body : integer
Method for reading the request body (eg. REQUEST_CHUNKED_ERROR, REQUEST_NO_BODY, REQUEST_CHUNKED_DECHUNK, etc…) Definition at line 978 of file httpd.h.
read_chunked : integer
Reading chunked transfer-coding/p>
expecting_100 : integer
Is client waiting for a 100 response?
content_type : string
The content-type for the current request.
handler : string
The handler string that we use to call a handler function.
content_encoding : string
How to encode the data.
content_languages : not implemented
Array of strings representing the content languages.
vlist_validator : not implemented
variant list validator (if negotiated)
user : string
If an authentication check was made, this gets set to the user name.
ap_auth_type : string
If an authentication check was made, this gets set to the auth type.
no_cache : integer
This response can not be cached.
no_local_copy : integer not implemented
There is no local copy of this response.
unparsed_uri : string
The URI without any parsing performed.
uri : string
The path portion of the URI.
filename : string
The filename on disk corresponding to this response.
canonical_filename : string
The true filename, we canonicalize r→filename if these don’t match.
path_info : string
The PATH_INFO extracted from this request.
args : string
The QUERY_ARGS extracted from this request.
finfo : not implemented
ST_MODE set to zero if no such file.
used_path_info : integer not implemented
Flag for the handler to accept or reject path_info on the current request.
All modules should respect the AP_REQ_ACCEPT_PATH_INFO and AP_REQ_REJECT_PATH_INFO values, while AP_REQ_DEFAULT_PATH_INFO indicates they may follow existing conventions. This is set to the user’s preference upon HOOK_VERY_FIRST of the fixups. Definition at line 1065 of file httpd.h.
per_dir_config : not implemented
Options set in config files, etc.
request_config : not implemented
Notes on this request.
htaccess : not implemented
A linked list of the .htaccess configuration directives accessed by this request.
N.B. always add to the head of the list, never to the end. that way, a sub request’s list can (temporarily) point to a parent’s list Definition at line 1083 of file httpd.h.
output_filters : not implemented
A list of output filters to be used for this request.
input_filters : not implemented
A list of input filters to be used for this request.
proto_output_filters : not implemented
A list of protocol level output filters to be used for this request.
proto_input_filters : not implemented
A list of protocol level input filters to be used for this request.
eos_sent : not implemented
A flag to determine if the eos bucket has been sent yet.

SEE ALSO

{{ include("includes/variables.sn") }}

AUTHOR

Written by Pierre Laplante and Caroline Laplante, <laplante@sednove.com>

MODIFICATIONS

1.0 2014-09-09 21:24:14 laplante@sednove.com

1.1 2016-08-02 laplante@sednove.com add parameter scheme version 5.68

Edit

© 2024 extenso Inc. All rights reserved.