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

set_include_path(string $include_path): string|false

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

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

Example #1 Exemplo de set_include_path()

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

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

Example #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);
?>