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.