Comentarios

Introduciendo Bloques de Código PHP y Comentarios

Cuando se trabaja con PHP, es esencial comprender cómo definir secciones de código que el intérprete de PHP debe ejecutar. Logramos esto encerrando nuestras instrucciones de PHP dentro de etiquetas especiales. La etiqueta de apertura, ``, marca su fin. Cualquier cosa encontrada entre estas etiquetas será procesada como instrucciones de PHP. Fuera de estas etiquetas, el texto se trata como texto estándar y se muestra directamente.

Por ejemplo, si tiene un archivo que contiene tanto código PHP como texto regular, el motor de PHP ejecutará el código encerrado dentro de las etiquetas ``, mientras que mostrará el texto restante tal cual. Una línea en blanco al final de un script PHP es una buena práctica para asegurar un aviso de terminal limpio después de la ejecución.

¿Por Qué Usar Comentarios en PHP?

Como la mayoría de los lenguajes de programación, PHP soporta comentarios. Los comentarios son secciones de texto dentro de tu código que el motor de PHP ignora completamente durante la ejecución. Sirven para una variedad de propósitos cruciales.

Principalmente, los comentarios te permiten agregar notas explicativas directamente en tu código. Estas notas pueden describir cómo funciona una sección particular de código, explicar el razonamiento detrás de una elección de diseño específica, o servir como un recordatorio para tareas futuras. Esto es invaluable tanto para ti mismo como para cualquier otra persona que pueda leer o mantener tu código.

Más allá de la documentación, los comentarios son increíblemente útiles durante el desarrollo. A veces, podría querer deshabilitar temporalmente un bloque de código sin borrarlo permanentemente – quizás cuando se está depurando o experimentando con un enfoque diferente. Simplemente convertir el código en un comentario le permite habilitar o deshabilitar rápidamente esa sección según sea necesario. Finalmente, los comentarios también se pueden usar para almacenar información para herramientas automatizadas, como generadores de documentación o marcos de pruebas.

Tipos de Comentarios de PHP

PHP ofrece una forma simple y directa para crear comentarios.

#### Comentarios de una línea

El tipo de comentario más común en PHP es el comentario de una línea. Estos comentarios comienzan con dos barras inclinadas (//). Todo en la misma línea después de esas dos barras inclinadas se considera un comentario y es ignorado por el intérprete de PHP. Esto le permite colocar un comentario junto a una declaración de PHP en la misma línea, sin afectar la ejecución de la declaración.

print 2 + 2; // This comment will be ignored and 4 will be printed

En este ejemplo, la declaración print seguirá ejecutándose, mostrando el resultado de 2 + 2. El texto que sigue a la // es puramente para la legibilidad humana.

Entendiendo Comentarios en PHP

Cuando se escribe código, es esencial incluir notas para uno mismo y otros desarrolladores. Estas se llaman comentarios, y PHP ofrece diferentes maneras de agregarlos. Un comentario simple de una sola línea comienza con //. Cualquier cosa que siga este marcador en la misma línea es ignorada por el intérprete de PHP. Por ejemplo, print 2 + 2; // Este es un comentario mostrará 4, pero el comentario en sí mismo no será ejecutado.

Para explicaciones más largas o secciones de código que desea deshabilitar temporalmente, puede usar comentarios de varias líneas. Estos comienzan con / y terminan con /. Todo lo que está entre estos marcadores también es ignorado.

/*
This is a multi-line comment.
It can span several lines of code.
This is useful for temporarily disabling a block of code.
*/

Mientras que podrías encontrar ocasionalmente código más antiguo usando comentarios de estilo shell (comenzando con #), la sintaxis // es la preferida y la forma más común de escribir comentarios de una sola línea en el desarrollo moderno de PHP.