Función require_once

La función require_once incluye el archivo especificado en el script actual. Si el archivo ya fue incluido previamente, la función no lo incluirá nuevamente. Esto es especialmente útil para incluir archivos con clases o funciones, donde la inclusión repetida puede causar errores.

Sintaxis

require_once 'path/to/file.php';

Ejemplo

Incluyamos el archivo config.php:

<?php
	require_once 'config.php';
	echo $config['site_name'];
?>

Resultado de la ejecución del código (si en config.php está definido el array $config):

'My Site'

Ejemplo

Intento de inclusión repetida del mismo archivo:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Esta llamada será ignorada
	echo sum(2, 3);
?>

Resultado de la ejecución del código:

5

Diferencia con require

A diferencia de require, la función require_once verifica si el archivo ya fue incluido y no realiza la inclusión repetida. Esto previene errores ante la inclusión múltiple del mismo archivo.

Ver también

la función include,
que también incluye archivos, pero no verifica su inclusión repetida
la función include_once,
que funciona de manera similar a require_once, pero no causa un error fatal si el archivo no existe