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

phprequire 'ruta/al/archivo.php';

Ejemplo

Inclusión de un archivo de configuración:

php<?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<?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<?php
  include 'archivo_opcional.php'; // El script continuará
  require 'archivo_requerido.php'; // El script se detendrá ante un error
?>

Véase también