Environment Variables¶

For each website, the following environment variables are created by default:

WEBSITE_SERVER_NAME: configured hostnames
WEBSITE_TYPE: website type
WEBSITE_WEBROOT: webroot location
FCGI_SOCKET_PATH: path to the fcgi socket (only when PHP is enabled)
PHP_VERSION: selected PHP version, only when PHP is enabled)
DB_HOST: database hostname (only if there is a database)
DB_NAME: database name (only if there is a database)
DB_USERNAME: database username (only if there is a database)
DB_PASSWORD: database password (only if there is a database)

Custom Environment Variables¶

You can set or override environment variables per website, use the envvar option in custom JSON:

{
  "envvar": {
    "MYENVVAR": "this is the value",
    "DB_HOST": "override global DB_HOST variable here",
    "http_proxy": "override global http_proxy variable here"
  }
}

Warning

Variable names can only contain lower and uppercase letters [A-Za-z], numbers [0-9] and underscores _, also they cannot begin with a number.

Example Usage in PHP¶

$config = array(
  'db_host'     => $_SERVER['DB_HOST'],
  'db_name'     => $_SERVER['DB_NAME'],
  'db_username' => $_SERVER['DB_USERNAME'],
  'db_password' => $_SERVER['DB_PASSWORD'],
)