set_include_path

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

set_include_pathSets the include_path configuration option

Description

set_include_path(string $include_path): string|false

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

Parameters

include_path

The new value for the include_path

Return Values

Returns the old include_path on success or false on failure.

Examples

Example #1 set_include_path() example

<?php
set_include_path
('/usr/lib/pear');

// Or using ini_set()
ini_set('include_path', '/usr/lib/pear');
?>

Example #2 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);
?>

See Also

add a note

User Contributed Notes 1 note

up
22
parks at vecinc dot com
15 years ago
If you find that this function is failing for you, and you're not sure why, you may have set your php include path in your sites's conf file in Apache (this may be true of .htaccess as well)

So to get it to work, comment out any "php_value include_path" type lines in your Apache conf file, and you should be able to set it now in your php code.
To Top