require, include, require_once, include_once en PHP: guía completa con ejemplos

require, include, require_once, include_once en PHP: ¿cuál elegir y por qué es importante?

¿Alguna vez te has preguntado: «¿Cuál es la diferencia real entre require e include en PHP? ¿Y para qué existen las versiones _once?» — Si es así, no estás solo. Esta pregunta está entre las más populares en Stack Overflow (miles de visitas y decenas de votos). Y no es casualidad.

Cada día, miles de desarrolladores PHP — desde principiantes hasta expertos — utilizan estas funciones. Pero muchos lo hacen de forma automática, sin pensar en las consecuencias. Y es un error. Una elección incorrecta puede provocar errores fatales, duplicación de código o, peor aún, bugs difíciles de detectar que solo aparecen en el servidor de producción.

Hoy vamos a aclarar de una vez por todas las diferencias entre require, include, require_once e include_once. No solo verás la teoría, sino también ejemplos de código funcionales que puedes probar ahora mismo. ¡Vamos allá!

1. Lo básico: ¿por qué incluir archivos?

Antes de hablar de diferencias, recordemos para qué sirve incluir archivos. En proyectos reales, el código PHP no se escribe en un solo archivo gigante. Sería un infierno de mantener. En su lugar, el código se divide en módulos:

\n
• Configuración — config.php
\n
• Funciones — functions.php
\n
• Plantillas — header.php, footer.php
\n
• Clases — User.php, Database.php
\n

Y aquí es donde entran require e include. Literalmente «pegan» el contenido de un archivo dentro de otro. PHP procesa el archivo incluido como si su código hubiera sido escrito justo en ese lugar.

2. require vs include: la diferencia clave es la reacción ante un error

Este es el punto más importante. Recuérdalo de una vez por todas.

include — inclusión suave

include intenta incluir el archivo. Si el archivo no existe o hay un error, PHP genera un Warning (aviso), pero continúa ejecutando el script.

<?php\n// include.php\necho "Esto es include. ";\ninclude 'archivo_inexistente.php'; // Genera un Warning\necho "¡El script sigue funcionando!";\n?>\n

Resultado:

Esto es include. Warning: include(archivo_inexistente.php): failed to open stream...\n¡El script sigue funcionando!

¿Ves? El script no se detiene, continúa. Esto es útil cuando la inclusión del archivo es opcional. Por ejemplo, si incluyes un widget que no es crítico para la página.

require — inclusión estricta

require hace lo mismo, pero con una diferencia: si el archivo no se encuentra, PHP genera un Fatal Error (error fatal) y detiene el script inmediatamente.

<?php\n// require.php\necho "Esto es require. ";\nrequire 'archivo_inexistente.php'; // Genera un Fatal Error\necho "¡Este código nunca se ejecutará!";\n?>\n

Resultado:

Esto es require. Fatal error: Uncaught Error: Failed opening required 'archivo_inexistente.php'...

El script muere. Fin. Silencio total.

¿Cuándo usar cada uno?

\n
• require — para archivos críticos: configuración de BD, clases principales, enrutador. Si faltan, el sitio no puede funcionar.
\n
• include — para bloques opcionales: plantillas, widgets, banners publicitarios. Si el archivo no se incluye, la página simplemente se muestra sin ese bloque.
\n

3. require_once y include_once: protección contra duplicados

Ahora imagina esta situación. Tienes un archivo config.php que declara constantes y funciones. Empiezas a