Estamos aprendiendo PHP con CodigoNautas. Hoy te explicaremos cómo ampliar tu código conectando un archivo PHP a otro y qué opción es mejor elegir según tu proyecto.

¿Para qué conectar archivos?

Primero, veamos por qué es necesario. Escribir todo el código en un solo script es imposible, poco práctico y simplemente extraño: crecerá hasta alcanzar un tamaño gigantesco y se volverá incómodo. Tendrás que dedicar mucho tiempo a mejorarlo y modificarlo.

PHP te permite complementar tu programa con nuevos scripts, esencialmente, fragmentos de código externos. Puedes distribuir todos los módulos del programa en diferentes carpetas, estructurarlos y aplicarlos según sea necesario.

¿Qué archivos puedes conectar?

Recomendamos usar archivos con la extensión .php. Durante la ejecución del script php, sucede lo siguiente:

  1. Al principio del archivo especificado, se detiene el análisis en modo código PHP.
  2. Cambia al modo HTML.
  3. Y continúa en PHP cuando el script termine.

Por lo tanto, el código dentro del script que necesitas ejecutar como PHP, lo envolvemos con las etiquetas correctas de inicio y fin de código PHP.

Una extensión diferente en los nuevos archivos también representa una amenaza para la seguridad. Asígnales los nombres que quieras, pero siempre escribe .php. De lo contrario, los estafadores podrían solicitar tu archivo y el servidor devolverá su código.

4 Maneras de Conectar Archivo PHP

Ejemplo práctico de cómo conectar un archivo PHP a un programa. Integración de archivos en código PHP.
Un ejemplo práctico de cómo conectar archivos PHP para optimizar tu código.

Puedes conectarlo de cuatro maneras:

  • include
  • require
  • include_once
  • require_once

Todas estas son construcciones especiales del lenguaje PHP para ampliar sus partes. Te explicaremos cada una con más detalle: cuál es la diferencia entre ellas y en qué situaciones usarlas.

Instrucción include

Si el archivo que conectaste con esta construcción no puede conectarse por alguna razón, simplemente obtendrás una advertencia — Warning. Si lo ignoras, la ejecución del script en este archivo no se detendrá.

El comando include (ver documentación) se usa para archivos cuya importancia no es crítica. Se registrará que uno no se conectó — “presta atención”. Pero el programa continuará funcionando sin él.

Supongamos que tienes el archivo Variable.php, y en él el siguiente código:

<?php
$count = 1;

Lo conectamos en el archivo index.php:

<?php
for($i=0;$i<2;$i++){
include ("Variable.php");
echo 'Valor de la variable - '.$count.'    ';
$count++;
}

Este código mostrará lo siguiente:

Valor de la variable - 1 Valor de la variable - 1

Con una conexión errónea:

<?php
for($i=0;$i<2;$i++){
include ("11Variable.php");
echo 'Valor de la variable - '.$count.'    ';
$count++;
}

Este código mostrará lo siguiente:

Valor de la variable - Valor de la variable - 1

Instrucción require

Si usas require y el archivo no se conecta, la ejecución del script terminará con un error fatal. Por ejemplo, se detendrá la carga de la página del sitio web.

Este comando (ver documentación) se aplica a aquellos archivos cuya conexión es fundamental. Sin ellos, el programa no puede funcionar, por lo que se detendrá.

El proceso es análogo a la instrucción include. Con una conexión errónea, el código se ve así:

<?php
for($i=0;$i<2;$i++){
require ("11Variable.php");
echo 'Valor de la variable - '.$count.'    ';
$count++;
}

Detendrá su trabajo en la primera iteración del ciclo después de intentar conectar el archivo.

Instrucción include_once

La construcción include con la adición _once significa que este archivo solo se puede conectar una vez. Los comandos sin el sufijo _once hacen que el archivo se conecte una, dos, tres veces. Si declaras la directiva include_once, se usa una vez. Esto ahorra un poco de espacio.

Ejemplo de instrucción:

<?php
for($i=0;$i<2;$i++){
include_once ("Variable.php");
echo 'Valor de la variable - '.$count.'    ';
$count++;
}

Este código mostrará lo siguiente:

Valor de la variable - 1 Valor de la variable - 2

Leer documentación aquí.

Instrucción require_once

Difiere de require solo en la relación con la cantidad de conexiones del script. En un código de programa grande puede haber muchas conexiones en cadena, y dentro de ellas pueden contener otros archivos. Si usas el comando include o require, toda esta cadena compleja se conectará constantemente cada vez.

Gracias a la directiva _once, el archivo se almacena con una marca de que ya se ha usado. Ya no lo tocamos ni lo usamos.

Leer documentación aquí.

💡
Cualquier archivo conectado tiene el mismo ámbito que la línea donde especificamos una de las directivas. Si la declaramos en medio del archivo, el ámbito será global. Si está dentro de una función, será local.

¿Qué método es mejor elegir?

Hemos revisado las cuatro opciones posibles para conectar un archivo PHP con el fin de ampliar el programa. Las óptimas son las construcciones con el sufijo _once.

Sin _once se produce una redefinición constante de las variables. Esto puede provocar errores algorítmicos. También es posible un error al llamar a una función que se encuentra en un archivo conectado dos veces. Por lo tanto, nuestra elección es include_once y require_once dependiendo de la importancia de los archivos para el funcionamiento del programa. Las instrucciones con sufijos ayudan a evitar errores relacionados con la reconexión.

Consejo de un perfeccionista

Para distinguir los archivos principales de los archivos conectados, los segundos se pueden renombrar. Por ejemplo, estás creando un sitio web en PHP. Agrega .inc a los archivos principales header.php, footer.php y otros. Obtendrás nombres como header.inc.php, footer.inc.php y similares. De esta manera, en la carpeta, entenderás inmediatamente qué scripts son principales y cuáles son secundarios.

Agregar .inc es solo para el formato visual: el método no tiene ninguna carga funcional. Pero la comodidad y la estructura son importantes en la programación, así que intenta hacer todo con un estilo uniforme.

Categorizado en:

PHP,