# set_include_path

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

set_include_path — Establece la opción de configuración include_path

### Descripción

set_include_path(string `$new_include_path`): string

Establece la opción de configuración include_path durante la duración del script.

### Parámetros

`new_include_path`

  El nuevo valor para include_path

### Valores devueltos

Devuelve el valor antiguo de include_path en caso de éxito o `false` en caso de error.

### Ejemplos

Ejemplo #1 Ejemplo de set_include_path()

`<?php
// Funciona a partir de PHP 4.3.0
set_include_path('/usr/lib/pear');
// Funciona en todas las versiones de PHP
ini_set('include_path', '/usr/lib/pear');
?>`

Ejemplo #2 Añadir a la ruta de inclusión

Haciendo uso de la constante `PATH_SEPARATOR` es posible extender la ruta de inclusión independientemente del sistema operativo.

En este ejemplo agregamos /usr/lib/pear al final del valor `include_path` actual.

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

### Ver también

- ini_set() - Establece el valor de una directiva de configuración
- get_include_path() - Obtiene la opción de configuración include_path actual
- restore_include_path() - Restablece el valor de la opción de configuración include_path
- include - include