# set_include_path

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

set_include_path — Modifie la valeur de la directive de configuration include_path

### Description

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

Modifie la valeur de la directive de configuration include_path, pour la durée du script en cours.

### Liste de paramètres

`include_path`

  La nouvelle valeur pour la directive de configuration include_path

### Valeurs de retour

Retourne l'ancienne valeur de include_path en cas de succès ou `false` si une erreur survient.

### Exemples

Exemple #1 Exemple avec set_include_path()

`<?php
set_include_path('/usr/lib/pear');
// Ou utiliser ini_set()
ini_set('include_path', '/usr/lib/pear');
?>`

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() - Modifie la valeur d'une option de configuration
- get_include_path() - Lit la valeur de la directive de configuration include_path
- restore_include_path() - Restaure la valeur de la directive de configuration include_path
- include - include