Incluir un archivo en una página PHP

Es muy sencillo incluir el mismo contenido en varias páginas del sitio mediante el uso de archivos de inclusión, archivos que se incluyen de forma dinámica en una página web cuando ésta se presenta en el explorador.

Los archivos de inclusión pueden facilitar la administración de los sitios. Por ejemplo, se puede crear un elemento de contenido, como un titular de página, un bloque de información del sitio o un menú para incluirlo en varias páginas del sitio. Cuando el usuario desea cambiar el contenido, puede hacerlo en un solo archivo y el cambio se reflejará en cada página en la que aparezca el archivo de inclusión.

Una instrucción de inclusión PHP es un bloque de código que extrae contenido de un archivo externo hacia una página web. A continuación se muestra un ejemplo de una instrucción de inclusión PHP:

<?php include('pageBanner.php'); ?>

Hay dos funciones de inclusión de PHP básicas: include() y require() . Las dos se comportan del mismo modo, pero devuelven errores distintos. Una función include() , si no se analiza correctamente, seguirá procesando el resto de la página y mostrará una advertencia en la página donde debería aparecer el archivo de inclusión. Si una función require() hace referencia a un archivo que falta, la función dejará de procesar la página y mostrará una página de error en el explorador. Para obtener más información acerca de include() y require() , vea la información sobre archivos de inclusión de PHP  (puede estar en inglés) en el sitio W3 Schools.

Las funciones include_once() y require_once() especifican que un archivo de inclusión se usará una sola vez en una página. Si dos funciones include() hacen referencia al mismo archivo de inclusión, en el explorador sólo se mostrará la primera función include() . Para obtener más información, vea la información sobre include_  y require_once  (puede estar en inglés) en el sitio PHP.NET.

Microsoft Expression Web admite el uso de cuatro tipo de archivos distintos como archivos de inclusión: archivos HTML, INC, PHP y TXT. Además, se pueden crear archivos de inclusión anidados. Por ejemplo, se puede crear un archivo de inclusión que contenga una referencia a otro archivo de inclusión.

Para insertar una función include() en una página web

1. En el menú Insertar, haga clic en PHP y, a continuación, haga clic en una de las siguientes funciones include() :

   • Include   Incluye el archivo cada vez que se hace referencia a él en la página.

   • Include_once   Incluye el archivo la primera vez que se hace referencia a él en la página.

   • Require   Requiere que el archivo se procese para poder devolver la página e incluye el archivo cada vez que se hace referencia a él en la página.

   • Require_once   Requiere que el archivo se procese para poder devolver la página e incluye el archivo la primera vez que se hace referencia a él en la página.

2. En el cuadro de diálogo Seleccione un archivo de inclusión, seleccione el archivo que desea incluir y haga clic en Abrir.

Vea también

Tareas

Cambiar el color del código PHP
Crear una página PHP
Insertar un script PHP
Obtener una vista previa de una página PHP
Mostrar u ocultar marcas de formato PHP en la Vista de diseño
Crear PHP mediante IntelliSense
Configurar las opciones de IntelliSense para PHP

Conceptos

Trabajar con sitios PHP
Usar IntelliSense con PHP

Copyright © 2011 de Microsoft Corporation. Reservados todos los derechos.