php man page for set_include_path

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)