Docs For Class Config

Config_Container (Constructor) [line 85]

Config_Container Config_Container(
[string
$type = 'section'], [string
$name = ''], [string
$content = ''], [array
$attributes = null])

Constructor

Parameters:

string	`$type`	—	Type of container object
string	`$name`	—	Name of container object
string	`$content`	—	Content of container object
array	`$attributes`	—	Array of attributes for container object

[ Top ]

addItem [line 119]

mixed &addItem(
object
&$item, [string
$where = 'bottom'], [object
$target = null])

Adds an item to this item.

Return: reference to added container on success, Pear_Error on error

Parameters:

object	`$item`	—	a container object
string	`$where`	—	choose a position 'bottom', 'top', 'after', 'before'
object	`$target`	—	needed if you choose 'before' or 'after' in $where

[ Top ]

countChildren [line 396]

int countChildren(
[string
$type = null], [string
$name = null])

Returns how many children this container has

Return: number of children found

Parameters:

string	`$type`	—	type of children counted
string	`$name`	—	name of children counted

[ Top ]

createBlank [line 178]

object reference &createBlank(
[mixed
$where = 'bottom'], [mixed
$target = null])

Adds a blank line to this item.

This is a helper method that calls createItem

Return: to new item or Pear_Error

[ Top ]

createComment [line 167]

object reference &createComment(
[string
$content = ''], [string
$where = 'bottom'], [object
$target = null])

Adds a comment to this item.

This is a helper method that calls createItem

Return: to new item or Pear_Error

Parameters:

string	`$content`	—	Object content
string	`$where`	—	Position : 'top', 'bottom', 'before', 'after'
object	`$target`	—	Needed when $where is 'before' or 'after'

[ Top ]

createDirective [line 194]

object reference &createDirective(
string
$name, string
$content, [mixed
$attributes = null], [string
$where = 'bottom'], [object
$target = null])

Adds a directive to this item.

This is a helper method that calls createItem

Return: to new item or Pear_Error

Parameters:

string	`$name`	—	Name of new directive
string	`$content`	—	Content of new directive
mixed	`$attributes`	—	Directive attributes
string	`$where`	—	Position : 'top', 'bottom', 'before', 'after'
object	`$target`	—	Needed when $where is 'before' or 'after'

[ Top ]

createItem [line 105]

object reference &createItem(
string
$type, mixed
$name, string
$content, [array
$attributes = null], [string
$where = 'bottom'], [object
$target = null], mixed
$item)

Create a child for this item.

Return: to new item or Pear_Error

Parameters:

string	`$type`	—	type of item: directive, section, comment, blank...
mixed	`$item`	—	item name
string	`$content`	—	item content
array	`$attributes`	—	item attributes
string	`$where`	—	choose a position 'bottom', 'top', 'after', 'before'
object	`$target`	—	needed if you choose 'before' or 'after' for where

[ Top ]

createSection [line 212]

object reference &createSection(
string
$name, [array
$attributes = null], [string
$where = 'bottom'], [object
$target = null])

Adds a section to this item.

This is a helper method that calls createItem If the section already exists, it won't create a new one. It will return reference to existing item.

Return: to new item or Pear_Error

Parameters:

string	`$name`	—	Name of new section
array	`$attributes`	—	Section attributes
string	`$where`	—	Position : 'top', 'bottom', 'before', 'after'
object	`$target`	—	Needed when $where is 'before' or 'after'

[ Top ]

directiveContent [line 376]

mixed directiveContent(
mixed
$args, [int
$index = -1])

Return a child directive's content.

This method can use two different search approach, depending on the parameter it is given. If the parameter is an array, it will use the Config_Container::searchPath() method. If it is a string, it will use the Config_Container::getItem() method.

Example:


1     require_once 'Config.php';
2      $ini = new Config();
3      $conf =& $ini->parseConfig('/path/to/config.ini', 'inicommented');
4     
5      // Will return the value found at :
6      // [Database]
7      // host=localhost
8      echo $conf->directiveContent(array('Database', 'host')));
9     
10     // Will return the value found at :
11     // date="dec-2004"
12     echo $conf->directiveContent('date');

Return: Content of directive or false if not found.
Access: public

Parameters:

mixed	`$args`	—	Search path and attributes or a directive name
int	`$index`	—	Index of the item in the returned directive list. Eventually used if args is a string.

[ Top ]

getAttribute [line 604]

mixed getAttribute(
string
$attribute)

Get one attribute value of this item

Return: item's attribute value

Parameters:

string $attribute — Attribute key

[ Top ]

getAttributes [line 594]

array getAttributes(
)

Get this item's attributes.

Return: item's attributes

[ Top ]

getChild [line 503]

mixed &getChild(
[mixed
$index = 0])

Returns the item parent object.

Return: returns reference to child object or false if child does not exist

[ Top ]

getContent [line 543]

string getContent(
)

Get this item's content.

Return: item's content

[ Top ]

getItem [line 238]

mixed &getItem(
[string
$type = null], [mixed
$name = null], [mixed
$content = null], [array
$attributes = null], [int
$index = -1])

Tries to find the specified item(s) and returns the objects.

Examples: $directives =& $obj->getItem('directive'); $directive_bar_4 =& $obj->getItem('directive', 'bar', null, 4); $section_foo =& $obj->getItem('section', 'foo');

This method can only be called on an object of type 'section'. Note that root is a section. This method is not recursive and tries to keep the current structure. For a deeper search, use searchPath()

Return: reference to item found or false when not found
See: &searchPath()

Parameters:

string	`$type`	—	Type of item: directive, section, comment, blank...
mixed	`$name`	—	Item name
mixed	`$content`	—	Find item with this content
array	`$attributes`	—	Find item with attribute set to the given value
int	`$index`	—	Index of the item in the returned object list. If it is not set, will try to return the last item with this name.

[ Top ]

getItemIndex [line 452]

int getItemIndex(
)

Returns the item index in its parent children array.

Return: returns int or null if root object

[ Top ]

getItemPosition [line 471]

int getItemPosition(
)

Returns the item rank in its parent children array according to other items with same type and name.

Return: returns int or null if root object

[ Top ]

getName [line 525]

string getName(
)

Get this item's name.

Return: item's name

[ Top ]

getParent [line 494]

object returns &getParent(
)

Returns the item parent object.

Return: reference to parent object or null if root object

[ Top ]

getType [line 561]

string getType(
)

Get this item's type.

Return: item's type

[ Top ]

isRoot [line 642]

bool isRoot(
)

Is this item root, in a config container object

Return: true if item is root

[ Top ]

removeItem [line 435]

mixed removeItem(
)

Deletes an item (section, directive, comment...) from the current object

TODO: recursive remove in sub-sections

Return: true if object was removed, false if not, or PEAR_Error if root

[ Top ]

searchPath [line 317]

mixed &searchPath(
mixed
$args)

Finds a node using XPATH like format.

The search format is an array: array(item1, item2, item3, ...)

Each item can be defined as the following: item = 'string' : will match the container named 'string' item = array('string', array('name' => 'xyz')) will match the container name 'string' whose attribute name is equal to "xyz" For example : <string name="xyz">

Return: Config_Container object, array of Config_Container objects or false on failure.
Access: public

Parameters:

mixed $args — Search path and attributes

[ Top ]

setAttributes [line 571]

void setAttributes(
array
$attributes)

Set this item's attributes.

Parameters:

array $attributes — Array of attributes

[ Top ]

setContent [line 534]

void setContent(
mixed
$content)

Set this item's content.

[ Top ]

setDirective [line 624]

object newly &setDirective(
string
$name, mixed
$content, [int
$index = -1])

Set a children directive content.

This is an helper method calling getItem and addItem or setContent for you. If the directive does not exist, it will be created at the bottom.

Return: set directive

Parameters:

string	`$name`	—	Name of the directive to look for
mixed	`$content`	—	New content
int	`$index`	—	Index of the directive to set, in case there are more than one directive with the same name

[ Top ]

setName [line 516]

void setName(
mixed
$name)

Set this item's name.

[ Top ]

setType [line 552]

void setType(
mixed
$type)

Set this item's type.

[ Top ]

toArray [line 679]

array toArray(
[bool
$useAttr = true])

Returns a key/value pair array of the container and its children.

Format : section[directive][index] = value If the container has attributes, it will use '@' and '#' index is here because multiple directives can have the same name.

Parameters:

bool $useAttr — Whether to return the attributes too

[ Top ]

toString [line 656]

mixed toString(
string
$configType, [array
$options = array()])

Call the toString methods in the container plugin

Return: true on success or PEAR_ERROR

Overridden in child classes as:

Config_Container_PHPConstants::toString(): Returns a formatted string of the object

Parameters:

string	`$configType`	—	Type of configuration used to generate the string
array	`$options`	—	Specify special options used by the parser

[ Top ]

updateAttributes [line 581]

void updateAttributes(
array
$attributes)

Set this item's attributes.

Parameters:

array $attributes — Array of attributes

[ Top ]

writeDatasrc [line 732]

mixed writeDatasrc(
mixed
$datasrc, string
$configType, [array
$options = array()])

Writes the configuration to a file

Return: true on success or PEAR_ERROR
Access: public

Overridden in child classes as:

Config_Container_PHPConstants::writeDatasrc(): Writes the configuration to a file

Parameters:

mixed	`$datasrc`	—	Info on datasource such as path to the configuraton file or dsn...
string	`$configType`	—	Type of configuration
array	`$options`	—	Options for writer

[ Top ]

Class: Config_Container

Class Overview

Author(s):

Variables

Methods

Child classes:

Inherited Variables

Inherited Methods

Class Details

Class Variables

$attributes =

$children = array()

$content = ''

$name = ''

$parent =

$type =

Method Detail

Config_Container (Constructor) [line 85]

Parameters:

addItem [line 119]

Parameters:

countChildren [line 396]

Parameters:

createBlank [line 178]

createComment [line 167]

Parameters:

createDirective [line 194]

Parameters:

createItem [line 105]

Parameters:

createSection [line 212]

Parameters:

directiveContent [line 376]

Parameters:

getAttribute [line 604]

Parameters:

getAttributes [line 594]

getChild [line 503]

getContent [line 543]

getItem [line 238]

Parameters:

getItemIndex [line 452]

getItemPosition [line 471]

getName [line 525]

getParent [line 494]

getType [line 561]

isRoot [line 642]

removeItem [line 435]

searchPath [line 317]

Parameters:

setAttributes [line 571]

Parameters:

setContent [line 534]

setDirective [line 624]

Parameters:

setName [line 516]

setType [line 552]

toArray [line 679]

Parameters:

toString [line 656]

Parameters:

updateAttributes [line 581]

Parameters:

writeDatasrc [line 732]

Parameters: