SQLPage built-in functions

In addition to normal SQL functions supported by your database, SQLPage provides a few special functions to help you extract data from user requests.

These functions are special, because they are not executed inside your database, but by SQLPage itself before sending the query to your database. Thus, they require all the parameters to be known at the time the query is sent to your database. Function parameters cannot reference columns from the rest of your query. The only case when you can call a SQLPage function with a parameter that is not a constant is when it appears at the top level of a SELECT statement. For example, SELECT sqlpage.url_encode(url) FROM t is allowed because SQLPage can execute SELECT url FROM t and then apply the url_encode function to each value.

The sqlpage.current_working_directory function

Introduced in SQLPage 0.11.0.

Returns the current working directory of the SQLPage server process.

Example

SELECT 'text' AS component;
SELECT 'Currently running from ' AS contents;
SELECT sqlpage.current_working_directory() as contents, true as code;

Result

Currently running from /home/user/my_sqlpage_website

Notes

The current working directory is the directory from which the SQLPage server process was started. By default, this is also the directory from which .sql files are loaded and served. However, this can be changed by setting the web_root configuration option.