Cómo usar include y require en PHP

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

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:tutorialprobando.php on line 2 Warning: include() [function.include]: Failed opening 'noexiste.php' for inclusion (include_path='.;C:php5pear') in C:tutorialprobando.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:tutorialprobando.php on line 2 Fatal error: require() [function.require]: Failed opening required 'noexiste.php' (include_path='.;C:php5pear') in C:tutorialprobando.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.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.

Autor: Lunatic

Usuarios que han visto este tema también han visto...

- Como generar un Thumbnail en PHP usando GD
- Incluyendo archivos con PHP
- Internacionalizacion mediante PHP
- Proteger las direcciones de correo en PHP
- Ejemplo practico expresiones regulares

- Versión imprimible de este documento

- Enviar por e-mail este documento