# set_include_path

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

set_include_path — 设置 include_path 配置选项

### 说明

set_include_path ( string `$new_include_path` ) : string

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

### 参数

`new_include_path`

  include_path 新的值。

### 返回值

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

### 范例

Example #1 set_include_path() 例子

    <?php
    set_include_path('/usr/lib/pear');

    // 或使用 ini_set
    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