array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.set-include-path.php', 1 => 'set_include_path', 2 => 'Sets the include_path configuration option', ), 'up' => array ( 0 => 'ref.info.php', 1 => 'PHP Options/Info Functions', ), 'prev' => array ( 0 => 'function.restore-include-path.php', 1 => 'restore_include_path', ), 'next' => array ( 0 => 'function.set-time-limit.php', 1 => 'set_time_limit', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/info/functions/set-include-path.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

set_include_path

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

set_include_path — Sets 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