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 sqlpage.protocol function

Introduced in SQLPage 0.17.1.

Returns the protocol that was used to access the current page.

This can be either http or https.

This is useful to generate links to the current page.

Example

select 'text' as component,
        sqlpage.protocol() || '://' || sqlpage.header('host') || sqlpage.path() as contents;

will return https://example.com/example.sql.

Note that the path is URL-encoded. The protocol is resolved in this order:

• Forwarded header
• X-Forwarded-Proto header request target / URI