set_include_path

Sets the include_path configuration option

&reftitle.description; `string` `set_include_path` `string` `new_include_path`

Sets the include_path configuration option for the duration of the script.

&reftitle.parameters;

`new_include_path`

- The new value for the include_path

&reftitle.returnvalues;

Returns the old include_path on success&return.falseforfailure;.

&reftitle.examples;

### `set_include_path` example

    <?php
    // Works as of PHP 4.3.0
    set_include_path('/usr/lib/pear');

    // Works in all PHP versions
    ini_set('include_path', '/usr/lib/pear');
    ?>

### Adding to the include path

Making use of the `PATH_SEPARATOR` constant, it is possible to extend the include path regardless of the operating system.

In this example we add `/usr/lib/pear` to the end of the existing `include_path`.

    <?php
    $path = '/usr/lib/pear';
    set_include_path(get_include_path() . PATH_SEPARATOR . $path);
    ?>

&reftitle.seealso;

- `ini_set`
- `get_include_path`
- `restore_include_path`
- `include`