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

phprequire_once 'path/to/file.php';

Ejemplo

Incluyamos el archivo config.php:

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):

php'My Site'

Ejemplo

Intento de inclusión repetida del mismo archivo:

php<?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:

php5

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