set_include_path

(PHP 4 >= 4.3.0, PHP 5)

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

Descrição

string set_include_path ( string new_include_path )

Define a opção de configuração include_path pela duração do script. Retorna o valor anterior de include_path em caso de sucesso ou FALSE em caso de falha.

Exemplo 1. Exemplo set_include_path()

<?php
// Funciona a partir do  PHP 4.3.0
set_include_path('/inc');

// Funciona em todas as versões
ini_set('include_path', '/inc');
?>

Exemplo 2. Adicionando mais entradas ao include path

Através do uso da constante PATH_SEPARATOR, é possível extender o include path sem levar em consideração o sistema operacional.

Neste exemplo, nós adicionamos /usr/lib/pear ao final do include_path existente.

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

Veja também ini_set(), get_include_path(), restore_include_path() e include().