libapreq - Apache Request C Library
This field is an Apache table that holds the parsed contents of GET and POST requests. Example:
table *data = req->parms; ap_table_set(data, "Key", "Value");
Limit the size of POST data. ApacheRequest_parse will return an error code if the size is exceeded:
int status; ApacheRequest *req = ApacheRequest_new(r);
req->post_max = 1204;
if((status = ApacheRequest_parse(req)) != OK) {
char *errmsg = ap_table_get(r->notes, "error-notes");
...
return status;
}
Disable file uploads. ApacheRequest_parse will return an error code if a file upload is attempted:
int status; ApacheRequest *req = ApacheRequest_new(r);
req->disable_uploads = 1;
if((status = ApacheRequest_parse(req)) != OK) {
char *errmsg = ap_table_get(r->notes, "error-notes");
...
return status;
}
Sets the directory where upload files are spooled.
char dir[] = "/usr/tmp"; req->temp_dir = dir;
Redirects upload data to be processed by the hook.
req->hook_data = (void *) data; req->upload_hook = (int(*)(void*,char*,int,ApacheUpload*)) func;
In this case
func(req->hook_data,buffer,bufsize,upload);
will be called repeatedly during the file upload instead of writing the data to a temp file.
This function creates a new ApacheRequest object using the given request_rec structure:
ApacheRequest *req = ApacheRequest_new(r);
If the request method is GET or POST, the query string arguments and the client form data will be read, parsed and saved. In addition, if the request method is POST and the Content-type is multipart/form-data, the uploaded files will be written to temporary files which can be accessed with the upload field names. The return value is OK on success, otherwise an error code that your handler should return.
This function will return the value of the given parameter key:
const char *value = ApacheRequest_param(req, "Key");
This function will return an array_header of values for the given parameter key:
array_header *values = ApacheRequest_params(req, "Key");
This function will format multi-value parmeters into a comma delimited string.
char *list = ApacheRequest_params_as_string(req, "Key");
If the request Content-type was that of multipart/form-data, this will return an ApacheUpload pointer containing the upload data, NULL otherwise. See ApacheUpload.
ApacheUpload *upload = ApacheRequest_upload(req);
The ApacheUpload structure holds all information for all uploaded files and is accessed via the upload field of an ApacheRequest structure.
The name of the filefield parameter:
char *name = upload->name;
The name of the upload file as reported by the client:
char *filename = upload->filename;
A file pointer to the uploaded file:
FILE *fp = upload->fp;
The name of the temporary upload file on the server:
char *tempname = upload->tempname;
The size of the uploaded file in bytes:
long size = upload->size;
The additional header information for the uploaded file:
table *info = upload->info; const char *type = ap_table_get(info, "Content-type");
Pointer to the next ApacheUpload structure if multiple files were uploaded:
ApacheUpload *uptr;
for (uptr = ApacheRequest_upload(req); uptr; uptr = uptr->next) {
char *name = uptr->name;
FILE *fp = uptr->fp;
...
}
Returns the ApacheUpload pointer associated with name or NULL if name is not found in the list:
ApacheUpload *upload = ApacheUpload_find(upload, name);
Shortcut for accessing the info table:
const char *type = ApacheUpload_info(upload, "Content-Type");
Shortcut for accessing the uploaded file Content-Type:
const char *type = ApacheUpload_type(upload);
This function creates a new ApacheCookie object, using the given request_request and optional attribute arguments which are as follows:
Example:
ApacheCookie *c = ApacheCookie_new(r,
"-name", "foo",
"-value", "bar",
"-expires", "+3M",
"-domain", ".cp.net",
"-path", "/mypath/database",
"-secure", "On",
NULL);
This function is used to get or set a cookie attribute pair, accepting the same attributes as the list above. Example:
char *name = ApacheCookie_attr(c, "-name"); /* same as c->name */ (void *)ApacheCookie_attr(c, "-expires", "+3h");
This function parses the given data string or the incoming Cookie header, returning an ApacheCookieJar of ApacheCookie objects.
Example:
int i;
ApacheCookieJar *cookies = ApacheCookie_parse(r, NULL);
for (i = 0; i < ApacheCookieJarItems(cookies); i++) {
ApacheCookie *c = ApacheCookieJarFetch(cookies, i);
int j;
for (j = 0; j < ApacheCookieItems(c); j++) {
char *name = c->name;
char *value = ApacheCookieFetch(c, j);
...
}
}
The number of values for the given cookie.
The nth value for the given cookie.
Add a new value to the cookie.
The number of cookies in the given cookie jar.
The nth cookie in the given cookie jar.
Add a new cookie to the cookie jar.
This function gets or sets the expiration date for cookie. The following forms are all valid for the time_str parmeter:
+30s 30 seconds from now
+10m ten minutes from now
+1h one hour from now
-1d yesterday (i.e. "ASAP!")
now immediately
+3M in three months
+10y in ten years time
Thursday, 25-Apr-1999 00:40:33 GMT at the indicated time & date
Put cookie in the oven to bake. (Add a Set-Cookie header to the outgoing headers table.)
ApacheCookie_bake(c);
Returns a string version of the cookie:
ap_table_add(r->headers_out, "Set-Cookie", ApacheCookie_as_string(c));
This library is based on Perl modules by Lincoln Stein.
Doug MacEachern, updated for v1.0 by Joe Schaefer