$cfg

Accessing configuration values

Most configuration values are written into a (deeply nested) global configuration variable called $cfg. In order to access these configuration values either the global variable itself (which used to be the standard approach) or the new registry class could be used which is the preferred approach since CONTENIDO 4.9.

// access the whole configuration array
$cfg = cRegistry::getConfig();
// access a single configuration array or value even allowing for a default value
$cfg = cRegistry::getConfigValue($sectionName, $optionName, $defaultValue);

Global configuration

Global configuration values can be defined as key value pairs of the array $cfg.

$cfg[<name>] = <value>;

Backend configuration

Backend configuration values can be defined as key value pairs of the array $cfg['backend'].

$cfg['backend'][<name>] = <value>;

Cache configuration

Cache configuration values can be defined as key value pairs of the array $cfg['cache'].

$cfg['cache'][<name>] = <value>;

Client template configuration

Client template configuration values can be defined as key value pairs of the array $cfg['client_template'].

$cfg['client_template'][<name>] = <value>;

Code generator configuration

Code generator configuration values can be defined as key value pairs of the array $cfg['code_generator'].

$cfg['code_generator'][<name>] = <value>;

CONTENIDO configuration

CONTENIDO configuration values can be defined as key value pairs of the array $cfg['contenido'].

$cfg['contenido'][<name>] = <value>;

Content type configuration

Content type configuration values can be defined as key value pairs of the array $cfg['content_types'].

$cfg['content_types'][<name>] = <value>;

Database configuration

Database configuration values can be defined as key value pairs of the array $cfg['db'].

$cfg['db'][<name>] = <value>;

Extended database settings. This settings will be used from CONTENIDO 4.9.0.

DBFS configuration

DBFS (database file system) values can be defined as key value pairs of the array $cfg['dbfs'].

$cfg['dbfs'][<name>] = <value>;

Debug configuration

Debug configuration values can be defined as key value pairs of the array $cfg['debug'].

$cfg['debug'][<name>] = <value>;

Default permission configuration

Default permission configuration values can be defined as key value pairs of the array $cfg['default_perms'].

$cfg['default_perms'][<name>] = <value>;

Image configuration

Image configuration values can be defined as key value pairs of the array $cfg['images'].

$cfg['images'][<name>] = <value>;

Inuse configuration

Inuse configuration values can be defined as key value pairs of the array $cfg['inuse'].

$cfg['inuse'][<name>] = <value>;

Language configuration

Language configuration values can be defined as key value pairs of the array $cfg['lang'].

$cfg['lang'][<name>] = <value>;

Password configuration

Password configuration values can be defined as key value pairs of the array $cfg['password'].

$cfg['password'][<name>] = <value>;

Path configuration

Path configuration values can be defined as key value pairs of the array $cfg['path'].

$cfg['path'][<name>] = <value>;

Path configuration values are URLs and filesystem paths or fragments of it:

• A URL path is a web addresse. E.g. http://192.168.1.1/test/
• A filesystem path is the path to a file or folder on the server's hard disk. E.g.: /var/www/html/contenido on *nix or C:\htdocs\contenido on Windows systems. There is no need to use backslashes on windows systems. Slashes are just fine here!

PHP settings configuration

PHP settings configuration values can be defined as key value pairs of the array $cfg['php_settings'].

$cfg['php_settings'][<name>] = <value>;

Configuration of different PHP settings. It is possible to configure each available PHP setting, which can be set by ini_set() method. All defined settings will be applied in contenido/includes/startup.php

Properties configuration

Properties configuration values can be defined as key value pairs of the array $cfg['properties'].

$cfg['properties'][<name>] = <value>;

Here you can configure the behavior of properties (user, group, system and general properties). Enabling caching for a specific properties will preload all related entries which enhances the performance during application lifecycle.

SQL configuration

SQL (or GenericDB) configuration values can be defined as key value pairs of the array $cfg['sql'].

$cfg['sql'][<name>] = <value>;

System log configuration

System log configuration values can be defined as key value pairs of the array $cfg['system_log'].

$cfg['system_log'][<name>] = <value>;

Table configuration

Table configuration values can be defined as key value pairs of the array $cfg['tab'].

$cfg['tab'][<name>] = <value>;

Template configuration

Template configuration values can be defined as key value pairs of the array $cfg['templates'].

$cfg['templates'][<name>] = <value>;

The list of available templates is far to long to be listed here.

URL builder configuration

URL builder configuration values can be defined as key value pairs of the array $cfg['url_builder'].

$cfg['url_builder'][<name>] = <value>;

Example setting for UriBuilder 'front_content' (generates URLs like '/cms/front_content.php?idcat=2&lang=1'):

$cfg['url_builder']['name']   = 'front_content';
$cfg['url_builder']['config'] = array();

Example setting for UriBuilder 'custom_path' (generates URLs like '/cms/Was-ist-Contenido/rocknroll,a,2.4fb'):

$cfg['url_builder']['name']   = 'custom_path';
$cfg['url_builder']['config'] = array('prefix' => 'rocknroll', 'suffix' => '.4fb', 'separator' => ',');

See also http://forum.contenido.org/viewtopic.php?f=64&t=23280

Validator configuration

Validator builder configuration values can be defined as key value pairs of the array $cfg['validator'].

$cfg['validator'][<name>] = <value>;