Función require

La función require incluye y ejecuta el archivo especificado en el script actual. A diferencia de include, si el archivo no existe genera un error fatal y detiene la ejecución del script. Esta función se utiliza frecuentemente para incluir archivos importantes con funciones, clases o configuraciones.

Sintaxis

require 'ruta/al/archivo.php';

Ejemplo

Inclusión de un archivo de configuración:

<?php
	require 'config.php';
	echo $db_host; // Variable de config.php
?>

Si el archivo config.php existe, su contenido será ejecutado y las variables estarán disponibles.

Ejemplo

Intento de incluir un archivo inexistente:

<?php
	require 'archivo_inexistente.php';
	echo 'Esta línea no se ejecutará';
?>

Si el archivo archivo_inexistente.php no existe, el script terminará con error.

Diferencia entre require e include

La principal diferencia es que require genera un error fatal si el archivo no existe, mientras que include solo muestra una advertencia.

<?php
	include 'archivo_opcional.php'; // El script continuará
	require 'archivo_requerido.php'; // El script se detendrá ante un error
?>

Véase también

la función include,
que también incluye archivos, pero no detiene el script ante un error
la función require_once,
que garantiza la inclusión única del archivo