Cuando empezamos a crear páginas web con PHP, es habitual que al principio cada archivo tenga todo su código escrito dentro del mismo documento. Por ejemplo, podemos tener una página index.php, otra llamada contacto.php, otra llamada productos.php y otra llamada servicios.php. Cada una de ellas puede tener su propio HTML completo, con su cabecera, su menú, su contenido principal y su pie de página.
El problema aparece cuando varias páginas comparten partes iguales. Imaginemos que todas las páginas tienen el mismo menú de navegación. Si escribimos ese menú directamente en cada archivo, estaremos repitiendo el mismo código una y otra vez. Esto puede parecer cómodo al principio, pero en cuanto el proyecto crece se convierte en un problema.
Por ejemplo, si queremos añadir una nueva opción al menú, tendríamos que modificar manualmente todos los archivos del sitio web. Si tenemos cuatro páginas, todavía es manejable. Pero si tenemos veinte, cincuenta o cien páginas, mantener ese código repetido se vuelve lento, incómodo y muy propenso a errores.
Para solucionar este problema, PHP nos permite separar partes comunes del código en archivos independientes y después insertarlas donde las necesitemos. Para eso usamos principalmente las instrucciones include y require.
Estas instrucciones permiten cargar el contenido de un archivo dentro de otro. Dicho de forma sencilla, PHP lee el archivo indicado y coloca su contenido justo en el punto donde hemos escrito el include o el require.
Esto es especialmente útil para crear partes reutilizables de una página web, como:
La cabecera HTML.
El menú de navegación.
El pie de página.
Barras laterales.
Formularios comunes.
Bloques de conexión a bases de datos.
Configuraciones compartidas.
En este tema vamos a centrarnos en el uso más inicial y visual: reutilizar fragmentos HTML comunes en varias páginas PHP.
El problema del código repetido
Supongamos que tenemos una página sencilla llamada index.php.
Si observamos los tres archivos, vemos que hay mucho código repetido. La cabecera, el menú y el pie de página aparecen una y otra vez.
Esto no es una buena práctica. Si queremos cambiar el título principal del sitio, modificar el menú o actualizar el pie de página, tendremos que hacerlo en todos los archivos.
La solución consiste en separar esas partes comunes en archivos independientes.
Qué es include
La instrucción include permite insertar el contenido de un archivo dentro de otro archivo PHP.
Su estructura básica es la siguiente:
include "archivo.php";
Cuando PHP encuentra esta línea, intenta buscar el archivo indicado y colocar su contenido en ese punto exacto.
Por ejemplo:
include "menu.php";
Esto significa que PHP cargará el archivo menu.php y mostrará su contenido justo donde aparece el include.
Crear un archivo común para el menú
Vamos a separar el menú de navegación en un archivo independiente.
Este archivo no necesita tener una estructura HTML completa. No necesita <!DOCTYPE html>, ni <html>, ni <head>, ni <body>, porque no representa una página completa. Solo contiene una parte de la página.
Ahora, si queremos modificar el menú, solo tenemos que cambiar el archivo menu.php. Todas las páginas que lo incluyan mostrarán automáticamente el menú actualizado.
Separar también la cabecera y el pie de página
El menú no es la única parte que podemos reutilizar. También podemos separar la cabecera y el pie.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title>Mi página web</title>
</head>
<body>
<?php include "header.php"; ?>
<?php include "menu.php"; ?>
<main>
<h2>Página de inicio</h2>
<p>Bienvenido a mi página web.</p>
</main>
<?php include "footer.php"; ?>
</body>
</html>
La página sigue funcionando igual, pero ahora está mejor organizada. Cada parte común está en su propio archivo.
Esta forma de trabajar es muy habitual en proyectos web. Permite dividir una página en piezas pequeñas, más fáciles de entender, mantener y reutilizar.
Una estructura básica de carpetas
Cuando un proyecto empieza a crecer, conviene organizar los archivos en carpetas.
Podemos crear una carpeta llamada includes para guardar los fragmentos comunes.
En este caso, como los archivos comunes están dentro de la carpeta includes, tenemos que indicar la ruta correctamente.
En index.php escribiríamos:
<?php include "includes/header.php"; ?>
<?php include "includes/menu.php"; ?>
<?php include "includes/footer.php"; ?>
La página completa quedaría así:
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title>Mi página web</title>
</head>
<body>
<?php include "includes/header.php"; ?>
<?php include "includes/menu.php"; ?>
<main>
<h2>Página de inicio</h2>
<p>Bienvenido a mi página web.</p>
</main>
<?php include "includes/footer.php"; ?>
</body>
</html>
Es importante entender que la ruta del archivo incluido depende de dónde se encuentra el archivo que está haciendo el include.
Si index.php está en la raíz del proyecto y header.php está dentro de la carpeta includes, la ruta correcta será:
include "includes/header.php";
Qué ocurre si el archivo no existe
Si usamos include y el archivo indicado no existe, PHP mostrará un aviso, pero intentará seguir ejecutando el resto de la página.
Por ejemplo:
<?php include "includes/cabecera.php"; ?>
Si el archivo cabecera.php no existe, PHP generará un mensaje de advertencia similar a este:
Warning: include(includes/cabecera.php): Failed to open stream...
Aunque aparezca el aviso, PHP intentará continuar con el resto del documento.
Esto puede ser útil en algunos casos, pero también puede ser peligroso si el archivo incluido es fundamental para que la página funcione correctamente.
Qué es require
La instrucción require también sirve para insertar el contenido de un archivo dentro de otro. Su uso es muy parecido al de include.
require "archivo.php";
La diferencia principal está en lo que ocurre si el archivo no se encuentra.
Con include, PHP muestra una advertencia y continúa ejecutando la página.
Con require, PHP muestra un error grave y detiene la ejecución.
Por ejemplo:
<?php require "includes/header.php"; ?>
Si el archivo existe, se carga normalmente. Pero si no existe, PHP detiene la página.
Esto tiene sentido cuando el archivo que estamos cargando es imprescindible.
Diferencia entre include y require
Aunque las dos instrucciones sirven para cargar archivos externos, no se comportan igual cuando hay un problema.
include se suele usar cuando el archivo que estamos cargando no es totalmente imprescindible. Si falla, la página puede seguir funcionando, aunque quizá no se muestre una parte concreta.
require se usa cuando el archivo es necesario para que la página funcione correctamente. Si el archivo no existe, lo mejor es detener la ejecución para evitar errores mayores.
Por ejemplo, en una página sencilla podríamos usar include para cargar un bloque visual como un aviso o una sección secundaria.
<?php include "includes/aviso.php"; ?>
Pero si en un proyecto más avanzado tenemos un archivo con la conexión a la base de datos, normalmente usaríamos require.
<?php require "includes/conexion.php"; ?>
En este tema estamos trabajando principalmente con HTML común, por lo que podemos empezar usando include. Más adelante, cuando trabajemos con configuración, sesiones, funciones o bases de datos, veremos que require puede ser más adecuado.
La palabra once significa “una vez”. Estas instrucciones cargan el archivo solo si no se ha cargado antes.
Esto es útil para evitar que el mismo archivo se incluya varias veces por error.
Por ejemplo:
<?php include_once "includes/menu.php"; ?>
Si el archivo menu.php ya se ha cargado antes, PHP no lo volverá a cargar.
Al principio, trabajando con cabeceras, menús y pies de página, normalmente nos bastará con include. Pero es importante conocer include_once y require_once, porque son muy habituales en proyectos más grandes.
Crear una plantilla básica reutilizable
Vamos a crear una estructura sencilla para una web con varias páginas.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title>Inicio</title>
<link rel="stylesheet" href="css/estilos.css">
</head>
<body>
<?php include "includes/header.php"; ?>
<?php include "includes/menu.php"; ?>
<main>
<h2>Inicio</h2>
<p>Esta es la página principal de nuestro sitio web.</p>
<p>El encabezado, el menú y el pie de página se cargan desde archivos externos.</p>
</main>
<?php include "includes/footer.php"; ?>
</body>
</html>
Creamos también la página servicios.php.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title>Servicios</title>
<link rel="stylesheet" href="css/estilos.css">
</head>
<body>
<?php include "includes/header.php"; ?>
<?php include "includes/menu.php"; ?>
<main>
<h2>Servicios</h2>
<p>En esta sección se mostrarían los servicios ofrecidos por la empresa o el proyecto.</p>
</main>
<?php include "includes/footer.php"; ?>
</body>
</html>
Y finalmente la página contacto.php.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title>Contacto</title>
<link rel="stylesheet" href="css/estilos.css">
</head>
<body>
<?php include "includes/header.php"; ?>
<?php include "includes/menu.php"; ?>
<main>
<h2>Contacto</h2>
<p>Desde esta página se podría mostrar un formulario de contacto.</p>
</main>
<?php include "includes/footer.php"; ?>
</body>
</html>
Con esta estructura ya tenemos una pequeña web dividida en partes reutilizables.
Si ahora queremos añadir una opción nueva al menú, solo tenemos que editar includes/menu.php.
Ahora no tenemos que cambiar manualmente el año cada vez que empiece uno nuevo. PHP lo calculará automáticamente.
Esto demuestra una de las ventajas de usar archivos .php para nuestros bloques comunes: pueden combinar HTML y código PHP.
Usar variables antes de incluir un archivo
También podemos preparar una variable en la página principal y usarla dentro de un archivo incluido.
Por ejemplo, podemos crear una variable llamada $tituloPagina.
En index.php:
<?php
$tituloPagina = "Inicio";
?>
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title><?php echo $tituloPagina; ?></title>
<link rel="stylesheet" href="css/estilos.css">
</head>
<body>
<?php include "includes/header.php"; ?>
<?php include "includes/menu.php"; ?>
<main>
<h2><?php echo $tituloPagina; ?></h2>
<p>Bienvenido a la página principal.</p>
</main>
<?php include "includes/footer.php"; ?>
</body>
</html>
También podríamos usar esa variable dentro de header.php.
Archivo includes/header.php:
<header>
<h1>Mi sitio web con PHP</h1>
<p>Estás visitando la sección: <?php echo $tituloPagina; ?></p>
</header>
Cuando index.php incluye header.php, el archivo incluido puede acceder a la variable $tituloPagina, porque se está insertando dentro del mismo contexto de ejecución.
Esto es muy útil, pero también exige orden. Si una variable se usa dentro de un archivo incluido, debemos asegurarnos de que se ha creado antes de hacer el include.
Ejemplo con varias páginas y título dinámico
Podemos aplicar la misma idea en todas las páginas.
Archivo index.php:
<?php
$tituloPagina = "Inicio";
?>
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title><?php echo $tituloPagina; ?></title>
<link rel="stylesheet" href="css/estilos.css">
</head>
<body>
<?php include "includes/header.php"; ?>
<?php include "includes/menu.php"; ?>
<main>
<h2><?php echo $tituloPagina; ?></h2>
<p>Bienvenido a la página principal.</p>
</main>
<?php include "includes/footer.php"; ?>
</body>
</html>
También conviene usar nombres claros. Un archivo llamado header.php se entiende mejor que uno llamado parte1.php. Un archivo llamado menu.php se entiende mejor que uno llamado navegacion2.php.
Otra recomendación importante es no abusar de los includes. Separar el código ayuda, pero si dividimos demasiado una página en muchos archivos pequeños sin necesidad, el proyecto puede volverse confuso. La idea es separar aquello que realmente se repite o que tiene sentido mantener de forma independiente.
En esta etapa inicial, lo más recomendable es usar include para partes visuales comunes como header.php, menu.php y footer.php.
Más adelante, cuando empecemos a trabajar con funciones, configuración, sesiones o bases de datos, tendrá sentido usar require o require_once para archivos imprescindibles.
Resumen práctico
include y require permiten cargar un archivo dentro de otro archivo PHP.
La instrucción include intenta cargar el archivo y, si no lo encuentra, muestra una advertencia pero permite que la página continúe ejecutándose.
La instrucción require también carga un archivo, pero si no lo encuentra detiene la ejecución de la página.
En proyectos web, estas instrucciones son muy útiles para evitar repetir código. Podemos crear archivos comunes como header.php, menu.php y footer.php, e incluirlos en todas las páginas que los necesiten.
Gracias a esto, nuestro proyecto queda más limpio, más ordenado y más fácil de mantener.
Actividad propuesta
Crea una pequeña web en PHP con tres páginas:
index.php
servicios.php
contacto.php
La web debe tener una carpeta llamada includes con los siguientes archivos:
header.php
menu.php
footer.php
Cada página debe cargar esos archivos usando include.
Además, cada página debe tener un contenido principal diferente dentro de la etiqueta <main>.
Como ampliación, crea una variable $tituloPagina en cada página y úsala para mostrar el título correspondiente tanto en la etiqueta <title> como dentro del contenido principal.
Preguntas de reflexión
¿Por qué no es recomendable copiar y pegar el mismo menú en todas las páginas de un sitio web?
¿Qué ventaja tiene guardar el menú en un archivo independiente?
¿Qué diferencia hay entre include y require?
¿Qué ocurre si usamos include y el archivo no existe?
¿Qué ocurre si usamos require y el archivo no existe?
¿Para qué podría servir include_once?
¿Por qué es importante organizar correctamente las carpetas de un proyecto?
¿Qué problemas pueden aparecer si indicamos mal la ruta de un archivo incluido?
<?php
$tituloPagina = "Inicio";
?>
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title><?php echo $tituloPagina; ?></title>
<link rel="stylesheet" href="css/estilos.css">
</head>
<body>
<?php include "includes/header.php"; ?>
<?php include "includes/menu.php"; ?>
<main>
<h2><?php echo $tituloPagina; ?></h2>
<p>Esta es la página principal del proyecto.</p>
</main>
<?php include "includes/footer.php"; ?>
</body>
</html>
En servicios.php, escribe:
<?php
$tituloPagina = "Servicios";
?>
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title><?php echo $tituloPagina; ?></title>
<link rel="stylesheet" href="css/estilos.css">
</head>
<body>
<?php include "includes/header.php"; ?>
<?php include "includes/menu.php"; ?>
<main>
<h2><?php echo $tituloPagina; ?></h2>
<p>En esta página se describen los servicios ofrecidos.</p>
</main>
<?php include "includes/footer.php"; ?>
</body>
</html>
En contacto.php, escribe:
<?php
$tituloPagina = "Contacto";
?>
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title><?php echo $tituloPagina; ?></title>
<link rel="stylesheet" href="css/estilos.css">
</head>
<body>
<?php include "includes/header.php"; ?>
<?php include "includes/menu.php"; ?>
<main>
<h2><?php echo $tituloPagina; ?></h2>
<p>Desde esta página se podría contactar con el sitio web.</p>
</main>
<?php include "includes/footer.php"; ?>
</body>
</html>
Cuando hayas terminado, abre el proyecto desde un servidor local como XAMPP, MAMP o un contenedor con Apache y PHP. Comprueba que las tres páginas muestran la misma cabecera, el mismo menú y el mismo pie de página.
Después modifica el archivo menu.php añadiendo una nueva opción llamada Blog.
