Configuring Virtual Hosts

In Monkey, every resource it's mapped under a Virtual Host. Every Virtual Host is defined by creating a configuration file under the conf/sites/ directory. Thus, a minimal required configuration is to having one virtual host, for that end is required the existence of at least one virtual host definition-file called default.

A Virtual Host definition, contains at least two sections named HOST and ERROR_PAGES:

HOST

This section contains relevate core configuration for the Virtual Host it self such as it's name and where the files are located.

[HOST]
    ServerName   127.0.0.1
    DocumentRoot /home/foo/monkey/htdocs

ServerName

It represents the Virtual Host name, it can be an IP address or any valid domain. The value of the ServerName key allows to set multiple names, e.g:

ServerName monkey-project.com foo.monkey-project.com bar.monkey-project.com

DocumentRoot

Each Virtual Host needs to know from where it should serve it's content. The DocumentRoot key represents the absolute path for a directory that contains static content to be exposed tthrough the Server, e.g:

DocumentRoot /home/foo/monkey/htdocs

The path must be a valid directory.

Redirect

In some cases you may want the HTTP server redirects each incoming request to the Virtual Host in question to a different location. For that purpose the key Redirect exists and can be assigned to any valid HTTP URL value, e.g:

Redirect http://monkey-project.com

Just note that the HTTP request will not be processed and just a HTTP redirect response will be send to the client.

ERROR_PAGES

When the resource requested by the HTTP client do not exists or cannot be accessed by some reason, a generic built-in page is serve explaining the nature of the problem. The ERROR_PAGES section defined in the Virtual Host configuration, allow to specify custom HTML pages to be serve when a specific HTTP error status is faced, an example of common errors are:

To add custom HTML pages and associate them to a specific error status code, the Key name is the status code and the value the static file that exists under the Virtual Host in context, e.g:

[ERROR_PAGES]
    404  404.html

On this example we are defining that for all HTTP 404 status code, the Server will send back as content body the file 404.html located under the DocumentRoot of this Virtual Host.

Plugins

Every Plugin may be able to define it owns sections on each Virtual Host, as an example we can mention the Logger plugin which defines rules for files where it will write server events. For every specific section found different than HOST and ERROR_PAGES, please refer to the plugin documentation for more details.