PHP include: Incluir archivos externos en los scripts

Vamos a ver cómo inluir archivos en nuestros scripts con PHP include. Estos archivos pueden ser otros PHPs, HTMLs… Esta práctica es habitual a la hora de estructurar la programación y así poder reutilizar el código el diferentes scripts de nuestras webs.

La funcionalidad de esta función es idéntica a la de PHP require. La diferencia entre ambas es que require en caso de error paraliza el script, mientras que include deja seguir el código del script. Podéis verlo en este post:

Diferencia entre PHP include y require

Otra manera de hacer includes en HTML es usando la directiva include virtual de SSI de Apache.

Sintaxis de PHP include

Veamos la sintaxis de esta función de PHP extraída de su web oficial:

include 'nombrefichero';
include ('nombrefichero');

1 2	include 'nombrefichero'; include ('nombrefichero');

Tal y como se puede ver en el código superior es muy sencillo incluir ficheros en nuestros scripts. Os he puesto las 2 sintaxis que hay, solamente tenemos que indicar la ruta dentro del servidor del archivo a incluir.

Aviso de error en el include

Pueden darse 2 tipos de errores bastante comunes:

Aviso Warning: El mensaje que nos aparece es el siguiente –> «failed to open stream: No such file or directory«, se da cuando el fichero incluido no se encuentra. El script se sigue ejecutando.
Error: Cuando se realiza el include se verifica el código del archivo incluido, en caso de ser un fichero PHP y que que contenga un error nos saldrá un mensaje por pantalla.

Ámbito de las variables en PHP include

Cuando el fichero es incluído se heredan las variables que contiene. Se podrá hacer uso de ellas a partir de la línea en la que se realizó el include.

Os muestro un ejemplo de variables heredadas.

$nombre = 'Pedro';
$apellido = 'Garcia';

1 2	$nombre = 'Pedro'; $apellido = 'Garcia';

El código superior pertenece al fichero include (nombreapellido.php) que vamos a llamar en el código inferior:

//la línea inferior no muestra el contenido de las variables porque no existen aun en el script
echo "El nombre es $nombre y el apellido es $apellido";

//realizamos el include
include 'nombreapellido.php';

//esta línea si muestra el contenido de las variables porque ya existen en el include
echo "El nombre es $nombre y el apellido es $apellido";

//la línea inferior no muestra el contenido de las variables porque no existen aun en el script

echo "El nombre es $nombre y el apellido es $apellido";

//realizamos el include

include 'nombreapellido.php';

//esta línea si muestra el contenido de las variables porque ya existen en el include

echo "El nombre es $nombre y el apellido es $apellido";

Ámbito de las funciones en PHP include

El mismo caso que en las variables se da con las funciones. Estas se heredan con todo su código. Os muestro un ejemplo.

function sacanombre()
    {
    $nombre = 'Pedro';
    $apellido = 'Garcia';
    echo "El nombre es $nombre y el apellido es $apellido";
    }

function sacanombre()

{

$nombre = 'Pedro';

$apellido = 'Garcia';

echo "El nombre es $nombre y el apellido es $apellido";

}

El código superior pertenece al fichero include (nombreapellido.php) que vamos a llamar en el código inferior:

//la línea inferior daría error porque aun no existe la función.
sacanombre();

//realizamos el include
include 'nombreapellido.php';

//esta si mostraría el contenido de la función
sacanombre();

//la línea inferior daría error porque aun no existe la función.

sacanombre();

//realizamos el include

include 'nombreapellido.php';

//esta si mostraría el contenido de la función

sacanombre();

Realizar includes vía http

Se pueden cargar ficheros externos a nuestro servidor realizando la llamada include, os pongo un par de ejemplos:

include 'http://www.miweb.com/archivo.php';

include 'http://www.miweb.com/archivo.php?variable1=11&variable2=22';

include 'http://www.miweb.com/archivo.php';

include 'http://www.miweb.com/archivo.php?variable1=11&variable2=22';

Os explico los 2 casos:

En la primera línea cargaríamos el fichero PHP dentro de nuestro script siempre y cuando no contenga errores.
En la segunda línea cargamos el fichero PHP y los parámetros pasados por GET serían válidos.

PHP include_once

include_once tiene el mismo comportamiento que include, la única diferencia entre ambas es que si el código del fichero ya se ha incluido, este no se incluye de nuevo.