Portada » Lenguaje PHP » Cómo usar include y require en PHP: EJEMPLOS

Cómo usar include y require en PHP: EJEMPLOS

Cómo usar include y require en PHP: EJEMPLOS. Cuando estemos desarrollando sistemas o páginas webs es muy cotidiano llegar a este tema de incluir ficheros PHP dentro de otro. Por lo tanto, podemos solicitar algunas funciones y/o conexiones con el servidor MySQL.

Cómo usar include y require en PHP: EJEMPLOS

Ahora, usualmente se usa son las funciones INCLUDE y REQUIRE, que sirven para añadir otros archivos a nuestros códigos en el lenguaje famoso PHP.

Sintaxis de include y require PHP

Les mostrare la forma de declararlos y su sintaxis son las siguientes.

<?php
// Include
include("la_ruta_de_archivo.php");
include "la_ruta_de_archivo.php";

// Require
require("la_ruta_de_archivo.php");
require "la_ruta_de_archivo.php";

?>

Diferencia entre include y require PHP

A continuación detallaremos las diferencias precisas de estas dos funciones.

  • INCLUDE, Esta función inserta código en nuestro archivo desde otro archivo, Si el archivo declarado no existe y/o tuviera alguna falla en su interior. PHP nos mostrar un mensaje tipo ‘warning‘ y nuestro código seguirá compilando.
  • REQUIRE, Realiza lo mismo que la anterior función. Sin embargo, si hay algún error en el código y/o no existiera nos mostrará un ‘fatal error‘ y nuestro fichero dejara de compilar y se detendrá.

Diferencias entre include_once y require_once

La diferencia entre estas 2 funciones del PHP se ejecuta cuando se declara más de una vez un archivo externo en nuestro código, este tratara de reconocer solo una vez. Por lo tanto, les mostrare la sintaxis de estas dos funciones require y/o include:

<?php
 
// Función require_once
require_once("la_ruta_de_archivo.php");
require_once "la_ruta_de_archivo.php";

// Include_once
include_once("la_ruta_de_archivo.php");
include_once "la_ruta_de_archivo.php";
?>

Líneas arriba explicamos cómo se comporta el require e include la diferencia general seria la forma de consignar los errores.

include_once. Esta declaración mostrara un ‘warning‘ y dejaría seguir la ejecución del script.

require_once. Esta declaración es más estricta y detendría toda ejecución del código mostrando un mensaje de ‘fatal error‘.

Descripción y ejemplos de Include Require

a) La función include

Esta sentencia es muy usado en el mundo del lenguaje PHP para no volver a escribir un bloque de código a cada rato. Por lo tanto, la utilización de esta función es muy recomendado por su forma de trabajar.

Archivo saludar.php

<?php
// Función saludar
    function saludar($nombre, $mensaje) {
        return "{$nombre}, {$mensaje}!";
    }
?>

En el código anterior estamos creando una función llamada «saludar«, algo muy sencillo como esto nos serviría para saludar a nuestros usuarios que se registren en nuestra web.

Hagamos un ejemplo completo y usemos  los archivos index.php y saludar.php. La idea es tener a la función saludar en otro archivo en este ejemplo «saludar.php» y llamarlo desde index.php

Fichero index.php

<?php

// Incluimos el fichero saludar.php
    include 'saludar.php';
// Impriminos el saludo a travez de una función que esta dentro del fichero saludar

    echo saludar('Ricardo Gareca', 'Buenas Dias');

?>

Ahora, tenemos un fichero llamado index.php con otro archivo llamado saludar.php, si notamos tenemos dos ficheros. Sin embargo, en index.php solo llamamos la función y listo ya tenemos nuestro saludo.

Entonces, include puede soportar varias formas de declaración que mostraremos a continuación.

Diferentes ejemplos para su utilización:

include 'saludar.php';
include 'directorio/saludar.php';
include 'directorio/directorio/saludar.php';
include '../directorio/saludar.php';
include '../../directorio/saludar.php';

Ejemplo de uso include

<!DOCTYPE html>
<html>
<head>
   <title>Usando Include PHP</title>
</head>
<body>
<?php include 'header.php'; ?>
<p> 
Aquí coloca tu contenido de tu sitio web.
</p>
<?php include 'footer.php'; ?>
</body>
</html>

b) La función require

Su comportamiento es el siguiente, si la línea declarada no existe o si tuviera algún error, PHP mostrara un mensaje de advertencia y seguirá el ejecutando.  Sin embargo, esto no debería ser lo normal.

Si requerimos de suma urgencia ese archivo como parte fundamental de su ejecución, include nos traerá problema. Por lo tanto, se recomienda el uso de la función REQUIRE

Este último, si el fichero no existe y/o tiene algún error mostrara un mensaje de fatal error y todo se detendrá hasta que el desarrollador corrija ese error.

El mensaje generado seria el siguiente:

Fatal error: require(): Failed opening required 'saludar.php'.

Usemos la misma base anterior.

I) Archivo saludar.php

<?php // Función saludar 
function saludar($nombre, $mensaje) { 
return "{$nombre}, {$mensaje}!";
 } 
?>

II) Archivo index.php

<?php

// Incluimos el fichero saludar.php
    require'saludar.php';
// Impriminos el saludo a travez de una función que esta dentro del fichero saludar

    echo saludar('Ricardo Gareca', 'Buenas Dias');

?>

C) La función require_once

En el desarrollo web, por agilizar la codificación hay errores al declarar y/o por falta de conocimientos declaramos dos o más veces un fichero externo: Sin embargo, no se preocupen, esto podemos solucionarlo usando la función require_once, Observemos su forma de uso:

Esto imprimirá un error intencionado. Porque, estamos requiriendo si o si de un fichero, pero declaramos doble.

<?php

require 'saludar.php';    
require 'saludar.php';

// Impriminos el saludo a travez de una función que esta dentro del fichero saludar

    echo saludar('Ricardo Gareca', 'Buenas Dias');

?>

Esto imprimirá un error de este tipo:

Fatal error: Cannot redeclare saludar().

La solución para este tipo de errores que son comunes cuando estemos desarrollando sistemas.

<?php
// La solución es usar Require_once

require_once 'saludar.php';    
require_once 'saludar.php';

// Impriminos el saludo a travez de una función que esta dentro del fichero saludar

    echo saludar('Ricardo Gareca', 'Buenas Dias');

?>
Cómo usar include y require en PHP: EJEMPLOS
Cómo usar include y require en PHP: EJEMPLOS

Resumiendo hay que usar la función require_once.

CONCLUSIÓN

¿Cuál me recomiendan usar?

  • Todo depende de la necesidad de tu proyecto,
  • Para vistas le recomendamos usar include
  • Si usamos clases seria require
  • En trabajo de equipo y códigos complejos require_once

Entonces, todo depende que analices tu trabajo y apliques cual te conviene.

Lo recomendable seria usar require siempre que el código sea importante (conexiones al servidor de base de datos, configuraciones, usuarios, etc.), y el  include se usaría en temas que su necesidad no es tan importante y vital para la compilación.

¿De cuánta utilidad te ha parecido este contenido?

¡Haz clic en una estrella para puntuarlo!

Promedio de puntuación 5 / 5. Recuento de votos: 2

Hasta ahora, ¡no hay votos!. Sé el primero en puntuar este contenido.

Scroll al inicio
Esta web utiliza cookies propias para su correcto funcionamiento. Contiene enlaces a sitios web de terceros con políticas de privacidad ajenas que podrás aceptar o no cuando accedas a ellos. Al hacer clic en el botón Aceptar, acepta el uso de estas tecnologías y el procesamiento de tus datos para estos propósitos.
Privacidad