object Config_Container::addItem (
object &$item
, string $where = 'bottom'
, object $target
= null
)
This method will add a Config_Container child to the current container
children. Thus, addItem() can only be called
one a section type container. If a position is specified,
the object will be added at this position. If
'before' or 'after'
are specified as position, a target object is required.
The object will then be added before or after the target
object position in the current container.
&$item
a container object
$where
choose a position 'bottom',
'top', 'after',
'before'
$target
needed if you choose 'before' or
'after' in $where.
$target must be one of this
container's children. ZendEngine2 will accept references
with default. It will then be possible to have
&$target instead.
object - A reference to the added object
| Error code | Error value | Meaning | Solution |
|---|---|---|---|
| " |
This function can not be called statically.
Adding an item using addItem()
<?php
$section =& new Config_Container('section', 'conf');
$directive =& new Config_Container('directive', 'user', 'mansion');
$section->addItem($directive);
?>
Adding an item using addItem() and a position relative to another item
<?php
$section =& new Config_Container('section', 'conf');
$directive =& new Config_Container('directive', 'user', 'mansion');
$section->addItem($directive);
$comment =& new Config_Container('comment', null, 'Here goes my name');
$section->addItem($comment, 'before', $directive);
?>