Función include_once

La función include_once incluye el archivo especificado en el script PHP actual, pero solo si no ha sido incluido previamente. Esto es especialmente útil cuando se trabaja con archivos que contienen declaraciones de funciones o clases, para evitar errores de redeclaración. A la función se le pasa como parámetro la ruta al archivo a incluir.

Sintaxis

include_once 'ruta/al/archivo.php';

Ejemplo

Incluyamos el archivo config.php solo una vez:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Esta llamada será ignorada
?>

Ejemplo

Intento de incluir un archivo que no existe:

<?php
	include_once 'nonexistent.php'; // Generará una advertencia, pero no detendrá la ejecución del script
	echo 'El script continúa...';
?>

Resultado de ejecutar el código:

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
El script continúa...

Ejemplo

Uso de variable para especificar la ruta:

<?php
	$rutaArchivo = 'lib/functions.php';
	include_once $rutaArchivo;
?>

Ver también

la función include,
que incluye un archivo sin verificar la inclusión repetida
la función require,
que incluye un archivo deteniendo el script en caso de error
la función require_once,
que funciona como include_once, pero detiene el script en caso de error