set_include_path

Function name: set_include_path()

Applicable versions: All PHP versions

Function description: The set_include_path() function is used to set the included file search path of PHP. By setting the included file search path, you can make PHP more flexible and convenient when including files.

Syntax: set_include_path(string $new_include_path): string|false

parameter:

• $new_include_path: The included file search path to be set, which can be a colon (:) separated string, or an array containing multiple paths.

Return value:

• If the included file search path is successfully set, a new search path string is returned.
• If the setting fails, false is returned.

Example:

1. Set a single path:

 $path = '/path/to/includes'; $result = set_include_path($path); if ($result !== false) { echo "包含文件搜索路径已设置为： $result"; } else { echo "设置包含文件搜索路径失败"; }

2. Set multiple paths:

 $paths = array( '/path/to/includes1', '/path/to/includes2', '/path/to/includes3' ); $result = set_include_path(implode(':', $paths)); if ($result !== false) { echo "包含文件搜索路径已设置为： $result"; } else { echo "设置包含文件搜索路径失败"; }

3. Get the current included file search path:

 $currentPath = get_include_path(); echo "当前的包含文件搜索路径为： $currentPath";

Notes:

• When setting up the included file search path, if the path contains a relative path, it will be parsed relative to the directory where the current script file is located.
• If the set path is invalid or does not exist, an error will occur when including the file.
• If the included file search path is not set, by default PHP will search in the directory where the current script file is located.