set_include_path — 设置 include_path 配置选项为当前脚本设置 include_path 运行时的配置选项。

说明

string set_include_path ( string $new_include_path )

为当前脚本设置 include_path 运行时的配置选项。

参数

new_include_path

include_path 新的值。

返回值

成功时返回旧的 include_path 或者在失败时返回 FALSE。

范例

Example #1 set_include_path() 例子

<?php
// 自 PHP 4.3.0 起可用
set_include_path('/usr/lib/pear');

// 在所有版本的 PHP 中均可用
ini_set('include_path', '/usr/lib/pear');
?>

Example #2 添加到include path

利用常量 PATH_SEPARATOR 可跨平台扩展 include path。

这个例子中我们把 /usr/lib/pear 添加到了
现有的 include_path 的尾部。

<?php
$path = '/usr/lib/pear';
set_include_path(get_include_path() . PATH_SEPARATOR . $path);
?>

参见

• ini_set() - 为一个配置选项设置值
• get_include_path() - 获取当前的 include_path 配置选项
• restore_include_path() - 还原 include_path 配置选项的值
• include - include