Define a opção de configuração include_path

# set_include_path

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

set_include_path — Define a opção de configuração include_path

### Descrição

function set_include_path(string `$include_path`): string|false

Define a opção de configuração include_path para toda a duração do script.

### Parâmetros

`include_path`

  O novo valor para o include_path

### Valor Retornado

Retorna o include_path antigo em caso de sucesso ou `false` em caso de falha.

### Exemplos

Exemplo #1 Exemplo de set_include_path()

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

    // Ou usando ini_set()
    ini_set('include_path', '/usr/lib/pear');
    ?>

Exemplo #2 Adicionando ao caminho de inclusão

Fazendo uso da constante `PATH_SEPARATOR`, é possível estender o caminho de inclusão independentemente do sistema operacional.

Neste exemplo foi adicionado o caminho /usr/lib/pear no final do `include_path` existente.

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

### Veja Também

- ini_set() - Define o valor de uma opção de configuração
- get_include_path() - Obtém a opção de configuração include_path atual
- restore_include_path() - Restaura o valor da opção de configuração include_path
- include - include

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open