14.8.2. PHP Extension Functions
The following functions have been added to the Virtuoso server in order to enable PHP processing.
PHP Server Handler.
__http_handler_php(
|
in file_name varchar, |
| in params vector (opt1, value [,...]) or string session, | |
| in lines vector (opt, value[,...] ), | |
inout what
any
); |
This function will be detected and called automatically by the Virtuoso HTTP/WebDAV server when a request for a file with extension .php is made.
-
The
file_name
argument will be the path to the file when the PHP page is stored on the file system or the actual content of the page when a WebDAV resource is processed.
-
The content of request entity body will be stored in a string session and passed down to the __http_handler_php as the
params
argument.
-
The HTTP request header will be passed as the
lines
argument.
-
The
what
parameter is used for in two ways: to indicate whether the first argument is a path/file name to a file on the filesystem or the content of the required WebDAV resource. The HTTP/WebDAV server will return an array of two elements to this parameter.
PHP Processor.
__http_php_str(
|
in string varchar, |
in params
vector (opt1, val1 [,...]) , varchar); |
This function takes a string containing PHP code (page), and parameters supplied in the params array and returns the result from the PHP engine as a string. This can be useful for performing PHP transformations in PL or VSP code.
-
the
string
is the source of the PHP page
-
params
is a string or array of strings containing parameter name and parameter value pairs. In the case of a single string it must contain form parameters in the application/x-www-form-urlencoded encoding. In case of an aref of strings it must contain the name and value for parameters. (Like the params argument in the VSPs).