SET_INCLUDE_PATH(3)							 1						       SET_INCLUDE_PATH(3)

set_include_path - Sets the include_path configuration option

SYNOPSIS

       string set_include_path (string	$new_include_path)

DESCRIPTION

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

PARAMETERS

	      o $new_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(3) 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');
	      ?>

       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

       ini_set(3), get_include_path(3), restore_include_path(3), include(3).

PHP Documentation Group 												       SET_INCLUDE_PATH(3)