Hosting
Hosting settings define what type of hosting is provided with a site. They are described by data type siteHostingAgentSet (site.xsd).
The graphical representation of siteHostingAgentSet (site.xsd) is as follows:
-
vrt_hst, required
This node contains virtual hosting settings. See the node definition below.
-
std_fwd, required
This node contains standard forwarding settings. Data type: domainFFHostingBase (
plesk_domain.xsd). -
frm_fwd, required
This node contains frame forwarding settings. Data type: domainSFHostingBase (
plesk_domain.xsd). - The dest_url, required
It specifies the URL to which users will be redirected at the attempt to visit the specified site. Data type: string.
- The http_code, required
It specifies the HTTP code for redirection when you use standard forwarding. Data type: integer.
- The none, required
This node is used when a site ships with a site. If specified, hosting settings will be deleted. Data type: none.
The graphical representation of the vrt_hst node is as follows:
-
property, required
It specifies a hosting parameter. Data type: PleskPhysHostingPropertyType (
plesk_domain.xsd).Note: You can use domain properties to set up custom PHP configuration for your domain. For this purpose, use the same syntax as for
php.ini(the name node should contain the name of a PHP parameter and the value node - its value). -
name, required
It specifies a hosting parameter name. Data type: string.
-
value, required
It specifies a hosting parameter value. Data type: any.
Note: You can specify multiple property parameters in one vrt_hst node.
The following code represents the PHP handler parameter:
<vrt_hst>
<property>
<name>php_handler_id</name>
<value>fastcgi</value>
</property>
</vrt_hst>
The List of Website Properties
The list of website properties contains hosting settings you can set with the property parameter. Note that allowed properties' values may vary depending on the server's operating system and the list of installed components. For example, you can assign the php_version property only those PHP versions that are installed on your server.
To get the exact list of parameters and their values available on your system for a particular website, retrieve a hosting settings descriptor using the filter by id as described in Getting Descriptors of Hosting Settings.
| Property name | Possible Values | Description |
|---|---|---|
|
ssl |
|
Turns on the SSL support for a website. |
|
iis_app_pool |
|
Turns on the dedicated IIS application pool for a website. Works on Windows only. |
|
php_handler_id |
|
Specifies a PHP handler for a website. |
|
ssi_html |
|
Turns on the support for SSI in *.htm and *.html files. Works on Windows only. |
|
managed_runtime_version |
May vary depending on installed components. |
Specifies the ASP.NET version for a website. Works on Windows only. |
|
www_root |
string |
Specifies the root directory for a website. Note: When you change the root directory of an existing website, Plesk creates new directory based on the Plesk's virtual host template. The previous root directory is kept as is. |
|
cgi_mode |
|
Specifies the location of the Works on Linux only. |
|
memory_limit |
string Note: Use the same values syntax as in the |
These properties allow you to set the corresponding PHP settings.
|
|
max_execution_time |
||
|
max_input_time |
||
|
post_max_size |
||
|
upload_max_filesize |
||
|
safe_mode |
||
|
safe_mode_include_dir |
||
|
safe_mode_exec_dir |
||
|
include_path |
||
|
session.save_path |
||
|
mail.force_extra_parameters |
||
|
register_globals |
||
|
open_basedir |
||
|
error_reporting |
||
|
display_errors |
||
|
log_errors |
||
|
allow_url_fopen |
||
|
file_uploads |
||
|
short_open_tag |
||
|
magic_quotes_gpc |
||
|
additional-directives |
string |
Specifies any PHP directive for a website. Use the same syntax as in the
For example, |
|
asp |
|
Turns on the ASP support for a website. |
|
asp_dot_net |
|
Turns on the ASP.NET support for a website. Works on Windows only. |
|
ssi |
|
service / domain, subdomain, webuser Turns on the SSI support for a website. |
|
php |
|
Turns on the PHP support for a website. |
|
cgi |
|
Turns on the CGI support for a website. |
|
perl |
|
Turns on the Perl support for a website. |
|
python |
|
Turns on the Python support for a website. |
|
fastcgi |
|
Turns on the FastCGI support for a website (required for Ruby on Rails). Works on Linux only. |
|
miva |
|
Turns on the Miva support for a website. |
|
webstat |
|
Specifies a statistics engine that will create reports on how a website is visited. |
|
errdocs |
|
Allows subscribers to design and use their own error pages that the web server returns with HTTP error codes. |
|
write_modify |
|
This option is required if subscriber's web apps use a file-based database (like Jet) located in the root directory of a website. Note that selecting this option might seriously compromise site security. Works on Windows only. |
|
web_deploy |
|
Allows subscribers to publish site content through Web Deploy. |
|
webstat_protected |
|
Specifies whether web statistics reports should be accessible through a specific password-protected directory. |
|
waf-rule-engine |
|
Switches the web application firewall for a site to either of the following modes: on, off, detection only. |
|
waf-rule-set |
|
Specifies the rule set that should be used by the web application firewall. Supported values: tortix (Atomic ModSecurity rule set) and crs (OWASP ModSecurity core rule set).
|
|
nginxServePhp |
|
Turns on the PHP-FPM support for a website. |
To get current property values of a particular domain, retrieve information about the domain using the get operator. See Getting Information About Sites.