PEAR Manual
PrevNext

Config_Container::createSection()

Config_Container::createSection() -- Add section to item

Synopsis

require_once 'Config/Container.php';

objectConfig_Container::createSection (string $name [, array $attributes = NULL [, string $where = 'bottom' [, object $target = NULL]]])

Description

Must be called on a section. This is a helper method that calls createItem()

Parameter

string $name

Name of new section

array array $attributes

Section attributes

string $where

Where to create the new item ('top', 'bottom', 'before', 'after')

object $target

Required only if 'before' or 'after' is used for $where

Return value

object - reference to new item

Throws

Table 31-1. Possible PEAR_Error values

Error codeError valueMeaningSolution
 ""  

Note

This function can not be called statically.

Example

Example 31-1. Create a new section using createSection()

$conf =& new Config_Container('section', 'MAIN');
$dbConf =& $conf->createSection('DB');
$dbConf->createDirective('user', 'mansion');
PrevHomeNext
Config_Container::createItem()UpConfig_Container::getAttribute()