PEAR Manual
Prev |  | Next

# Config_Container::createDirective()

Config_Container::createDirective() -- Add directive to item

## Synopsis

    require_once 'Config/Container.php';

``object Config_Container::createDirective` (string $name, string $content [, mixed $attributes = `NULL` [, string $where = 'bottom' [, mixed $target = `NULL`]]])`

## Description

The current item must be a section. This is a helper method that calls createItem()

## Parameter

string `$name`

  Name of new directive

string `$content`

  Content of new directive

mixed `$attributes`

  Directive 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 code | Error value | Meaning | Solution
--- | --- | --- | ---
| "" |  |

## Note

This function can not be called statically.

## Example

Example 31-1. Create a new directive using createDirective()
    $section =& new Config_Container('section', 'conf');
    $section->createDirective('user', 'mansion');

Prev | Home | Next
Config_Container::createComment() | Up | Config_Container::createItem()