Reply a PWP file. This interface is provided to server
individual locations from PWP files. Using a PWP file rather
than generating the page from Prolog may be desirable because
the page contains a lot of text (which is cumbersome to generate
from Prolog) or because the maintainer is not familiar with
Prolog.
Options supported are:
- mime_type(+Type)
- Serve the file using the given mime-type. Default is
text/html.
- unsafe(+Boolean)
- Passed to http_safe_file/2 to check for unsafe paths.
- pwp_module(+Boolean)
- If
true
, (default false
), process the PWP file in
a module constructed from its canonical absolute path.
Otherwise, the PWP file is processed in the calling
module.
Initial context:
- SCRIPT_NAME
- Virtual path of the script.
- SCRIPT_DIRECTORY
- Physical directory where the script lives
- QUERY
- Var=Value list representing the query-parameters
- REMOTE_USER
- If access has been authenticated, this is the authenticated
user.
- REQUEST_METHOD
- One of
get
, post
, put
or head
- CONTENT_TYPE
- Content-type provided with HTTP POST and PUT requests
- CONTENT_LENGTH
- Content-length provided with HTTP POST and PUT requests
While processing the script, the file-search-path pwp includes
the current location of the script. I.e., the following will
find myprolog in the same directory as where the PWP file
resides.
pwp:ask="ensure_loaded(pwp(myprolog))"
- See also
- - pwp_handler/2.
- To be done
- - complete the initial context, as far as possible from CGI
variables. See http://hoohoo.ncsa.illinois.edu/docs/cgi/env.html