PHP include: qué es, cómo funciona y cuándo usarlo

La función include es una de las características más útiles y potentes de PHP. Te permite incluir el contenido de un archivo externo dentro de otro archivo. De esta forma, puedes separar tu código en diferentes archivos y luego combinarlos según tus necesidades.

Usar la función include tiene muchas ventajas. Por ejemplo, puedes crear un archivo con el menú o el pie de página de tu sitio web y luego incluirlo en todas las páginas que quieras. Así, si quieres cambiar algo en el menú o en el pie de página, solo tendrás que modificar un archivo y los cambios se verán reflejados en todas las páginas.

Además, usar la función include te ayuda a evitar errores y a mejorar la seguridad de tu código. Si incluyes un archivo que contiene funciones o variables que ya has definido previamente, PHP no te dará ningún error ni sobrescribirá tus definiciones. También puedes incluir archivos desde otras fuentes (por ejemplo, desde otro servidor) siempre que tengas permiso para hacerlo.

En este artículo te explicaremos cómo usar la función include de PHP con ejemplos prácticos. También te daremos algunos consejos y buenas prácticas para sacarle el máximo partido a esta función. Al final del artículo serás capaz de crear sitios web más dinámicos, flexibles y fáciles de mantener con PHP.

Índice

Sintaxis
Ejemplos de PHP include
- Ejemplo 1: Incluir un archivo local
- Ejemplo 2: Incluir un archivo remoto
Consejos al usar PHP include
Conclusión

Sintaxis

La sintaxis básica de la función include es la siguiente:

include 'nombre_del_archivo';

Donde ‘nombre_del_archivo’ es el nombre del archivo que quieres incluir. Puede ser un nombre relativo (por ejemplo, ‘menu.php’) o un nombre absoluto (por ejemplo, ‘http://www.ejemplo.com/menu.php’). El archivo puede tener cualquier extensión, pero normalmente se usa la extensión ‘.php’ para indicar que contiene código PHP.

La función include se puede usar en cualquier parte del código PHP, dentro o fuera de las etiquetas '' y ''. Cuando se usa la función include, PHP trata el contenido del archivo incluido como si fuera parte del archivo principal. Es decir, ejecuta el código PHP que haya en el archivo incluido y muestra el resultado en el lugar donde se ha usado la función include.

La función include tiene algunas variantes que se comportan de forma ligeramente diferente. Estas son:

include_once: Esta función hace lo mismo que include, pero solo incluye el archivo una vez. Si intentas incluir el mismo archivo más de una vez con esta función, PHP lo ignorará. Esto es útil para evitar duplicar código o definiciones.
require: Esta función hace lo mismo que include, pero con una diferencia importante. Si el archivo que quieres incluir no existe o no se puede leer, PHP dará un error fatal y detendrá la ejecución del script. Esto es útil para asegurarte de que el archivo incluido es esencial para el funcionamiento del script.
require_once: Esta función combina las características de require y include_once. Solo incluye el archivo una vez y da un error fatal si no lo encuentra o no lo puede leer.

Ejemplos de PHP include

Para que veas cómo funciona la función include de PHP en la práctica, te vamos a mostrar algunos ejemplos sencillos pero ilustrativos. Puedes probar estos ejemplos por ti mismo creando los archivos correspondientes y ejecutándolos en tu servidor local o remoto.

Ejemplo 1: Incluir un archivo local

Supongamos que tenemos un archivo llamado ‘saludo.php’ que contiene el siguiente código:

<?php
   echo "Hola, bienvenido a mi sitio web.";
?>

Y otro archivo llamado ‘principal.php’ que contiene el siguiente código:

<html>
   <head>
      <title>Mi sitio web</title>
   </head>
   <body>
      <?php
         include 'saludo.php';
      ?>
      <p>Este es el contenido de mi página principal.</p>
   </body>
</html>

Si ejecutamos el archivo ‘principal.php’, veremos lo siguiente en el navegador:

Hola, bienvenido a mi sitio web. Este es el contenido de mi página principal.

Como puedes ver, PHP ha incluido el contenido del archivo ‘saludo.php’ en el lugar donde hemos usado la función include. De esta forma, podemos reutilizar el mismo saludo en otras páginas sin tener que repetirlo.

Ejemplo 2: Incluir un archivo remoto

Supongamos que tenemos un archivo llamado ‘noticias.php’ que está alojado en otro servidor y contiene el siguiente código:

<?php
   echo "Estas son las últimas noticias:";
   echo "<ul>";
   echo "<li>Noticia 1</li>";
   echo "<li>Noticia 2</li>";
   echo "<li>Noticia 3</li>";
   echo "</ul>";
?>

Y otro archivo llamado ‘principal.php’ que contiene el siguiente código:

<html>
   <head>
      <title>Mi sitio web</title>
   </head>
   <body>
     <?php
         include 'http://www.ejemplo.com/noticias.php';
      ?>
      <p>Este es el contenido de mi página principal.</p>
   </body>
</html>

Si ejecutamos el archivo ‘principal.php’, veremos lo siguiente en el navegador:

Estas son las últimas noticias:

Noticia 1
Noticia 2
Noticia 3

Este es el contenido de mi página principal.

Como puedes ver, PHP ha incluido el contenido del archivo ‘noticias.php’ desde otro servidor en el lugar donde hemos usado la función include. De esta forma, podemos mostrar información actualizada desde otra fuente sin tener que copiarla o descargarla.

Consejos al usar PHP include

Ahora que ya sabes cómo usar la función include de PHP, te vamos a dar algunos consejos y buenas prácticas para que la uses de forma segura y eficiente. Estos son:

Evita usar rutas relativas: Cuando incluyes un archivo local, es mejor que uses una ruta absoluta o una constante predefinida (como DIR o FILE) para indicar la ubicación del archivo. Esto te evitará problemas si cambias la estructura de tu sitio web o si usas la función include desde diferentes niveles de directorios.
Comprueba la existencia del archivo: Antes de incluir un archivo, puedes usar la función file_exists() o is_readable() para comprobar si el archivo existe y se puede leer. Esto te ayudará a evitar errores fatales si el archivo no está disponible o tiene algún problema.
Protege tus archivos incluidos: Si tus archivos incluidos contienen información sensible o código que no quieres que se ejecute directamente, puedes protegerlos con algunas medidas. Por ejemplo, puedes usar una extensión diferente a ‘.php’ para que el servidor no los interprete como código PHP. O puedes usar una condición al principio del archivo para comprobar si se está incluyendo desde otro archivo o no (por ejemplo, usando la variable $_SERVER[‘SCRIPT_FILENAME’]).
Usa las variantes adecuadas: Dependiendo de tus necesidades, puedes usar las variantes include_once, require o require_once en lugar de include. Estas variantes tienen sus propias ventajas e inconvenientes, así que úsalas con criterio y coherencia.

Conclusión

En este artículo te hemos enseñado cómo usar la función include de PHP para incluir el contenido de un archivo externo dentro de otro archivo. Esta función te permite simplificar y organizar mejor tu código PHP, reutilizar el mismo código en diferentes páginas, facilitar el mantenimiento y la actualización de tu sitio web y mejorar la seguridad y la eficiencia de tu código.

También te hemos mostrado algunos ejemplos prácticos de cómo usar la función include en diferentes situaciones y te hemos dado algunos consejos y buenas prácticas para que la uses correctamente.

Esperamos que este artículo te haya sido útil y que hayas aprendido algo nuevo sobre PHP. Te animamos a que pruebes la función include por ti mismo y que explores sus posibilidades. Estamos seguros de que te sorprenderás de lo que puedes hacer con ella.