Archivos de inclusión de PHP
La declaración include(o require) toma todo el texto/código/marcado que existe en el archivo especificado y lo copia en el archivo que usa la declaración de inclusión.
Incluir archivos es muy útil cuando desea incluir el mismo PHP, HTML o texto en varias páginas de un sitio web.
PHP incluye y requiere declaraciones
Es posible insertar el contenido de un archivo PHP en otro archivo PHP (antes de que el servidor lo ejecute), con la instrucción include o require.
Las declaraciones include y require son idénticas, excepto en caso de falla:
requireproducirá un error fatal (E_COMPILE_ERROR) y detendrá el scriptincludesolo producirá una advertencia (E_WARNING) y el script continuará
Por lo tanto, si desea que la ejecución continúe y muestre a los usuarios el resultado, incluso si falta el archivo de inclusión, use la declaración de inclusión. De lo contrario, en el caso de FrameWork, CMS o una codificación de aplicación PHP compleja, utilice siempre la instrucción require para incluir un archivo clave en el flujo de ejecución. Esto ayudará a evitar comprometer la seguridad e integridad de su aplicación, en caso de que se pierda accidentalmente un archivo clave.
Incluir archivos ahorra mucho trabajo. Esto significa que puede crear un encabezado, pie de página o archivo de menú estándar para todas sus páginas web. Luego, cuando el encabezado deba actualizarse, solo puede actualizar el archivo de inclusión del encabezado.
Sintaxis
include 'filename';
or
require 'filename';
PHP incluyen ejemplos
Ejemplo 1
Supongamos que tenemos un archivo de pie de página estándar llamado "footer.php", que se ve así:
<?php
echo "<p>Copyright © 1999-" . date("Y") . " W3Schools.com</p>";
?>
Para incluir el archivo de pie de página en una página, utilice la includedeclaración:
Ejemplo
<html>
<body>
<h1>Welcome to my home page!</h1>
<p>Some text.</p>
<p>Some more text.</p>
<?php include 'footer.php';?>
</body>
</html>
Ejemplo 2
Supongamos que tenemos un archivo de menú estándar llamado "menu.php":
<?php
echo '<a href="/default.asp">Home</a> -
<a href="/html/default.asp">HTML Tutorial</a> -
<a href="/css/default.asp">CSS Tutorial</a> -
<a href="/js/default.asp">JavaScript Tutorial</a> -
<a href="default.asp">PHP Tutorial</a>';
?>
Todas las páginas del sitio Web deben utilizar este archivo de menú. Así es como se puede hacer (estamos usando un elemento <div> para que el menú se pueda diseñar fácilmente con CSS más adelante):
Ejemplo
<html>
<body>
<div class="menu">
<?php include 'menu.php';?>
</div>
<h1>Welcome to my home page!</h1>
<p>Some text.</p>
<p>Some more text.</p>
</body>
</html>
Ejemplo 3
Supongamos que tenemos un archivo llamado "vars.php", con algunas variables definidas:
<?php
$color='red';
$car='BMW';
?>
Luego, si incluimos el archivo "vars.php", las variables se pueden usar en el archivo de llamada:
Ejemplo
<html>
<body>
<h1>Welcome to my home page!</h1>
<?php include 'vars.php';
echo "I have a $color $car.";
?>
</body>
</html>
PHP incluye vs requiere
La requiredeclaración también se usa para incluir un archivo en el código PHP.
Sin embargo, hay una gran diferencia entre incluir y requerir; cuando se incluye un archivo con la includedeclaración y PHP no puede encontrarlo, el script continuará ejecutándose:
Ejemplo
<html>
<body>
<h1>Welcome to my home page!</h1>
<?php include 'noFileExists.php';
echo "I have a $color $car.";
?>
</body>
</html>
Si hacemos el mismo ejemplo usando la requiredeclaración, la declaración de eco no se ejecutará porque la ejecución del script muere después de que la
requiredeclaración devolviera un error fatal:
Ejemplo
<html>
<body>
<h1>Welcome to my home page!</h1>
<?php require 'noFileExists.php';
echo "I have a $color $car.";
?>
</body>
</html>
Úselo requirecuando la aplicación requiera el archivo.
Utilícelo includecuando el archivo no sea necesario y la aplicación deba continuar cuando no se encuentre el archivo.