Cómo usar include y require en PHP (Cristalab)

Estás en: Cristalab > Tutoriales > Cómo usar include y require en PHP

Cómo usar include y require en PHP

Por: Lunatic Lycanthrop + Otros tutoriales de Lunatic Lycanthrop + 4 de Diciembre del 2006

Autor

Lunatic Lycanthrop
clabLevel: 1350
5 Tutoriales
1 Ejemplos

Un include es un elemento del lenguaje PHP que nos permite incluir una página entera dentro de otra.

¿Por qué usar los includes?

El uso de includes es excepcionalmente bueno para ahorrarte trabajo. Puedes hacer un header o un menú generico y cargarlo con el include.

Uso:

La utilización del include es muy simple:

<?php include("tuarchivo.htm"); ?>

Ejemplo:

Vamos a usar tres archivos, que fusionaremos. Luego observaremos el codigo de salida.

Archivo 1 : header.php :

<html>
<head>
<title> Muestra de includes </title>

</head>
<body>

Archivo 2: footer.php :

</body>
</html>

Archivo 3: union.php :

<?php include("header.php"); ?>
<p>
Hola, este es el contenido.
</p>
<?php include("footer.php"); ?>

Y el resultado:

<html>
<head>
<title> Muestra de includes </title>
</head>
<body>

<p>
Hola, este es el contenido.
</p>
</body>
</html>

Nota: Los archivos a incluír no tienen que ser obligatoriamente archivos PHP. Pueden ser de cualquier tipo

Diferenciación:

PHP contiene otra funcion con caracteristicas muy similares, que es la funcion require(). Las caracteristicas y el modo de uso de include y de require son identicas, salvo por una cosa: El mensaje de error generado si falta un documento:

Con include, si el nombre de archivo no existe, recibiras una advertencia (warning) y el script seguirá. Con require en cambio el script se detendrá, pues se marcará un error fatal.

Ejemplo:

Include:

<?php
include("noexiste.php");
echo ("Hola. El script siguió!");
?>

Y lo que obtendremos:

Warning: include(noexiste.php) [function.include]:
failed to open stream:
No such file or directory in C:\tutorial\probando.php on line 2

Warning: include() [function.include]:
Failed opening 'noexiste.php' for inclusion
(include_path='.;C:\php5\pear')
in C:\tutorial\probando.php on line 2

Hola. El script siguió!

Require:

<?php
require("noexiste.php");
echo ("Hola. El script siguió!");
?>

Y aqui obtenemos:

Warning: require(noexiste.php) [function.require]:
failed to open stream:
No such file or directory in C:\tutorial\probando.php on line 2

Fatal error: require() [function.require]:
Failed opening required 'noexiste.php'
(include_path='.;C:\php5\pear')
in C:\tutorial\probando.php on line 2

Vemos que con require no se ejecutó la siguiente parte del script. Atención: En php 3 y anteriores, las funciones include y require se diferenciaban por un asunto aún mayor: Include podía ser usado condicionalmente, mientras que require se ejecutaba "a la fuerza". Un ejemplo:

<?php
        $gatito= "Lo odio";
        if($gatito=="Lo amo"){
                include("condicionado-asi-que-si-no-es-verdad-no-me-incluyo.php");
        }else{
                require("igual-me-voy-a-incluir-bwahahaha.php");
        }
?>

En el output, veremos que se incluiría lo del require y no lo del include. Sin embargo, reitero, esto ya no funciona asi.

Información adicional

Si tienes alguna pregunta de este tutorial; puedes hacerla aqui en los foros

Cristalab