Los comentarios en PHP - Curso de PHP y MySQL - Capítulo 3

Los comentarios son algo necesario en cualquier lenguaje de programación. No utilizarlos es una gran desventaja, ya que sirven para anular trozos de código, sin borrarlo y explicar cada parte del código.

Los comentarios de una línea de PHP

Los comentarios de una sola línea se suelen utilizar para aportar pequeños comentarios que solo ocupan una línea como este:

Código PHP


// Esto va a imprimir el texto en el documento.
echo "Estamos viendo los comentarios en PHP.";

Resultado en el navegador 

Estamos viendo los comentarios en PHP.

Los comentarios son ignorados por el navegador, por lo tanto, sirven solo para quien los lee. No afectan en nada más.

Puedes escribir comentarios a la derecha de la instrucción:

Código PHP


echo "Estamos viendo los comentarios en PHP."; // Esto va a imprimir el texto en el documento.

Resultado en el navegador 

Estamos viendo los comentarios en PHP.

En PHP tenemos otro tipo de comentarios de una línea:

Código PHP


	echo "Estamos viendo los comentarios en PHP."; # Esto es un comentario de una línea.

Resultado en el navegador 

Estamos viendo los comentarios en PHP.

Los comentarios multilínea de PHP

En PHP disponemos de comentarios multilínea que son capaces de ocupar tantas líneas como queramos. Además de para comentarios un poco más extensos que los de una línea, nos permiten anular trozos de código de modo que no lo borremos. Esto es útil cuando no sabemos si borraremos algo defenitivamente o para probar el código sin ese trozo.

Código PHP


	/*
	echo "Estamos viendo los comentarios en PHP.";
	echo "Estos echo se van a ignorar por el navegador.";
	*/
	echo "Los otros echo se ha ignorado.";

Resultado en el navegador 

Los otros echo se ha ignorado.

Código PHP


	echo/* Este comentario está dentro de una instrucción */
	"Estamos viendo los comentarios en PHP.";

Resultado en el navegador

El contenido de la instrucción se muestra correctamente y esto no genera errores. No obstante, es muy mala práctica, ya que entorpece a la hora de leer el código y puede conducir a errores fácilmente.

Estamos viendo los comentarios en PHP.