set_include_path

(PHP 4 >= 4.3.0, PHP 5)

set_include_path --  Modifie la valeur de la directive de configuration include_path

Description

string set_include_path ( string new_include_path )

set_include_path() modifie la valeur de la directive de configuration include_path, pour la durée du script en cours. Elle retourne l'ancienne valeur de include_path en cas de succès, et FALSE sinon.

Exemple 1. Exemple avec set_include_path()

<?php
// Fonctionne depuis PHP 4.3.0
set_include_path('/inc');

// Fonctionne sur toutes les versions
ini_set('include_path', '/inc');
?>

Exemple 2. Ajout dans le chemin d'inclusion

En utilisant la constante PATH_SEPARATOR, il est possible d'étendre le chemin d'inclusion au vu du système.

Dans cet exemple, nous ajoutons /usr/lib/pear à la fin de l'actuel include_path.

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

Voir aussi ini_set(), get_include_path(), restore_include_path() et include().