¿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, debe tener 3 líneas de comentarios por cada 10 líneas de código
En este tutorial, aprenderá:
- Comentarios PHP
- PHP Incluir y PHP Incluir_una vez
- Ejemplo: Incluir / Incluir_una vez
- PHP Require y PHP require_once
- Ejemplo: Requerir
- PHP incluye vs requiere
Comentarios PHP
- Los comentarios nos ayudan a comprender 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.
- Los comentarios de varias líneas comienzan con una barra inclinada seguida de un asterisco / * y terminan con un asterisco seguido de una barra inclinada * /.
El siguiente diagrama muestra un archivo PHP con comentarios de líneas múltiples y de una sola línea Ejemplo de PHP
PHP Incluir y PHP Incluir_una vez
La declaración php "incluir" se utiliza para incluir otros archivos en un archivo PHP.
Tiene dos variaciones, include e include_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
La declaración include_once tiene la siguiente sintaxis
AQUÍ,
- "Incluir / incluir_una vez" es la declaración que incluye el archivo
- “'Nombre_archivo'” es el nombre del archivo que se incluirá.
Ejemplo: Incluir / Incluir_una vez
Suponga que está desarrollando 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 utilizando la declaración de inclusión. Veamos cómo se puede hacer esto.
- Crearemos 2 nombres de archivos
- header.php, index.php
A continuación se muestran los códigos para; header.php
HomeAbout usServicesContact Us
index.php
Aparecerá la página de encabezado de arriba
PHP Require y PHP require_once
La declaración require tiene dos variaciones, require y require_once.
La instrucción require / require_once se usa para incluir file.
Require_once se ignora si el archivo requerido ya ha sido agregado por cualquiera de las cuatro declaraciones de inclusión.
Tiene la siguiente sintaxis
AQUÍ,
- "Require / require_once" es la declaración que incluye el archivo
- “'Nombre_archivo'” es el nombre del archivo que se incluirá.
Ejemplo: Requerir
Supongamos que estamos desarrollando una aplicación con 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. config.php
Veamos ahora el código de muestra que requiere el archivo de configuración. Pages_model.php
PHP incluye vs requiere
La diferencia entre incluir / requerir
| Incluir | 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 ocurre un error. |
Por lo general, se recomienda utilizar la declaración de inclusión para que, cuando se produzca 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 instrucción require debe usarse si no se puede ejecutar el script completo sin el archivo solicitado.
Las declaraciones "incluir" y "requerir" se pueden utilizar 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.
- El código PHP, como la configuración de la base de datos, las funciones personalizadas, etc., se puede compartir en muchas páginas, lo que garantiza que el sitio web o 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 inclinadas dobles //.
- Las declaraciones de comentarios de varias líneas se incluyen 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 utilizando 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 instrucció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 donde sin el archivo solicitado para ser incluido, no se puede ejecutar el script completo.