Environment
Currently, there are two environment configuration items available for Swarm:
-
mode: whether Swarm operates in production or development mode.
-
hostname: specifies the canonical hostname Swarm should use, such as in links to Swarm in email notifications.
Add the following configuration block to the
data/config.php file:
<?php
// this block should be a peer of 'p4'
'environment' => array(
'mode' => 'development', // defaults to 'production'
'hostname' => 'myswarmhostname', // defaults to requested hostname
),
Mode
By default, Swarm operates in production mode. When
mode is set to development,
Swarm displays greater error detail in the browser. Also, Swarm switches
from including aggregated and minified javascript and CSS to requesting
each javascript and CSS resource for all active modules. The default value
is production. Any value other than
development is assumed to mean
production.
development mode makes it easier to discover problems
and to identify their source, but also incurs additional browser overhead
due to many more javascript and CSS requests for larger files. We
recommend that you do not use development mode in
production environments, unless directed to do so by Perforce technical
support.
Hostname
The hostname item allows you to specify Swarm's
hostname. This could be useful if you have multiple virtual hosts deployed
for a single Swarm instance; Swarm uses the hostname you configure when
generating its web pages and email notifications.