Comentarios PHP, Incluir/Incluir_once, Requerir/Requerir_once

ยฟPor quรฉ utilizar comentarios?

  • Si no trabaja en el cรณdigo fuente durante algรบn tiempo, es fรกcil olvidar lo que hace el cรณdigo. Comentar el cรณdigo fuente ayuda a recordar lo que hace el cรณdigo.
  • Comentar el cรณdigo fuente tambiรฉn es muy importante cuando varios desarrolladores tienen que trabajar en el mismo proyecto. Los cambios realizados por un desarrollador pueden ser entendidos fรกcilmente por otros desarrolladores simplemente leyendo los comentarios.
  • Como prรกctica recomendada, debes tener 3 lรญneas de comentarios por cada 10 lรญneas de cรณdigo.

Comentarios PHP

  • Los comentarios nos ayudan a entender el cรณdigo.
  • Los comentarios son explicaciones que incluimos en nuestro cรณdigo fuente. Estos comentarios son para la comprensiรณn humana.
  • Los comentarios de una sola lรญnea comienzan con dos barras diagonales // y terminan en la misma lรญnea.
  • Comentarios PHP
  • Los comentarios de varias lรญneas comienzan con una barra diagonal seguida de un asterisco /* y terminan con un asterisco seguido de una barra diagonal */.
  • Comentarios PHP

El siguiente diagrama muestra un archivo PHP con comentarios de varias lรญneas y de una sola lรญnea.

Ejemplo de PHP

Ejemplo de comentarios PHP

PHP incluye y PHP incluye_once

La declaraciรณn php "incluir" se utiliza para incluir otros archivos en un archivo PHP.

Tiene dos variaciones, incluir e incluir_once. El intรฉrprete de PHP ignora Include_once si el archivo que se va a incluir.

La declaraciรณn de inclusiรณn tiene la siguiente sintaxis

<?php
include 'file_name';
?>

La declaraciรณn include_once tiene la siguiente sintaxis

<?php
include_once 'file_name';
?>

AQUร,

  • โ€œInclude/include_onceโ€ es la declaraciรณn que incluye el archivo
  • โ€œ'file_name'โ€ es el nombre del archivo que se incluirรก.

Ejemplo: Incluir/Incluir_once

Supongamos que estรกs desarrollandoping Un sitio web que contiene el mismo menรบ de navegaciรณn en todas las pรกginas.

Puede crear un encabezado comรบn y luego incluirlo en cada pรกgina usando la declaraciรณn de inclusiรณn. Veamos cรณmo se puede hacer esto.

  • Crearemos 2 nombres de archivos.
  • encabezado.php, รญndice.php

A continuaciรณn se muestran los cรณdigos para; header.php

<a href="index.php">Home</a>

<a href="aboutus.php">About us</a>

<a href="services.php">Services</a>

<a href="contactus.php">Contact Us</a>

index.php

<?php

include 'header.php';

?>

La pรกgina de encabezado de arriba generarรก

PHP requiere y PHP require_once

La declaraciรณn require tiene dos variaciones, require y require_once.

La declaraciรณn require/require_once se utiliza para incluir el archivo.

Require_once se ignora si cualquiera de las cuatro declaraciones de inclusiรณn ya ha agregado el archivo requerido.

Tiene la siguiente sintaxis

<?php
require 'file_name';
?>
<?php
require_once 'file_name';
?>

AQUร,

  • โ€œrequire/require_onceโ€ es la declaraciรณn que incluye el archivo
  • โ€œ'file_name'โ€ es el nombre del archivo que se incluirรก.

Ejemplo: Requerir

Supongamos que estamos desarrollandoping una aplicaciรณn basada en base de datos.

Podemos crear un archivo de configuraciรณn que podemos incluir en todas las pรกginas que se conectan a la base de datos usando la declaraciรณn require. configuraciรณn.php

<?php

$config['host'] = 'localhost';

$config['db'] = 'my_database';

$config['uid'] = 'root';

$config['password'] = '';

?>

Veamos ahora el cรณdigo de muestra que requiere el archivo de configuraciรณn. Pรกginas_modelo.php

<?php

require 'config.php'; //require the config file

//other code for connecting to the database

?>

PHP incluye vs requiere

La diferencia entre incluir/requerir

incluyen Exigir
Emite una advertencia cuando ocurre un error No emite una advertencia
La ejecuciรณn del script continรบa cuando ocurre un error. La ejecuciรณn del script se detiene cuando se produce un error.

Generalmente, se recomienda utilizar la declaraciรณn de inclusiรณn para que cuando ocurra un error, la ejecuciรณn del script continรบe mostrando la direcciรณn de correo electrรณnico del webmaster o la pรกgina de contacto.

La declaraciรณn require debe usarse si no se puede ejecutar todo el script sin el archivo solicitado.

Las declaraciones "incluir" y "requerir" se pueden usar en cualquier lรญnea de los cรณdigos fuente donde desee que aparezca el cรณdigo.

Resumen

  • El cรณdigo HTML รบnico, como encabezados, pies de pรกgina, barras laterales, etc., se puede compartir en muchas pรกginas. Esto facilita la actualizaciรณn del sitio web con solo actualizar un solo archivo.
  • Cรณdigo PHP como los ajustes de configuraciรณn de la base de datos, funciones personalizadas, etc., se pueden compartir en muchas pรกginas, lo que garantiza que el sitio web/la aplicaciรณn utilice la misma configuraciรณn.
  • Los comentarios se utilizan para ayudar a comprender el cรณdigo fuente. Son para el entendimiento humano.
  • Las declaraciones de comentarios de una sola lรญnea comienzan con barras diagonales dobles //.
  • Las declaraciones de comentarios de varias lรญneas estรกn encerradas entre /* declaraciones */.
  • Las declaraciones "include, include_once, require y require_once" se utilizan para incluir archivos.
  • Include_once/require_once se ignora si el archivo solicitado ya se ha incluido mediante cualquiera de las cuatro declaraciones.
  • La declaraciรณn "incluir" emite una advertencia y continรบa con la ejecuciรณn si no se ha encontrado el archivo solicitado.
  • La declaraciรณn require genera un error fatal y detiene la ejecuciรณn del script.
  • La declaraciรณn "incluir" debe ser en la mayorรญa de los casos, excepto en situaciones en las que sin el archivo solicitado para incluir, no se puede ejecutar todo el script.

Resumir este post con: