Ver índice
Líneas de comentario

        Ocultar índice  

   Índice de contenidos
   Instalación en Windows
   Instalación en Ubuntu
   Servidores seguros
   Páginas dinámicas
   Sintaxis básica
   Operaciones
   Arrays
   Formatos de presentación
   Operadores
   Bucles
   Extraer y ord. información
   Funciones
   Ficheros externos
   Imágenes dinámicas
   Gestión de directorios
   Cookies y sesiones
   Clases y objetos
   Ficheros en formato PDF
   Bases de datos MySQL
   PHP y XML
   PDO - Bases SQLite / MySQL
   MySQL a traves de misqli
   Algo de JavaScript y AJAX


¿Por qué usar líneas de comentario?

A primera vista pueden parecer inútiles. ¿Para qué recargar las páginas con contenidos que no se van a ver ni ejecutar?. Las líneas de comentario sirven para poder recordar en un futuro qué es lo que hemos hecho al escribir un script y por qué razón lo hemos hecho así.

A medida que vayamos avanzando verás que en muchos casos tendremos que aplicar estrategias individuales para resolver cada problema concreto. Cuando necesites hacer una corrección o una modificación al cabo de un tiempo verás que confiar en la memoria no es una buena opción. Es mucho mejor utilizar una línea de comentario que confiar en la memoria. ¡Palabra!

Comentarios

Para insertar comentarios en los scripts de PHP podemos optar entre varios métodos y varias posibilidades:

Una sola linea

Basta colocar los símbolos // al comienzo de la línea o detrás del punto y coma que señala el final de una instrucción. También se puede usar el símbolo # en cualquiera de las dos posiciones.

Varias líneas

Si un comentario va a ocupar más de una línea podremos escribir /* al comienzo de la primera de ellas y */ al final de la última. Las líneas intermedias no requieren de ningún tipo de marca. Los comentarios para los que usemos la forma /* ... */ no pueden anidarse. Si, por error, lo hiciéramos PHP nos dará un mensaje de error.

Ensayando líneas de comentario

En este ejemplo hemos incluido –marcados en rojo– algunos ejemplos de inserción de líneas de comentario.

<html>
<head>
<title>Ejemplo 9</title></head>
<body>
<?php
// Este comentario no se verá en la página

    echo "Esto se leerá <BR> "; // Esto no se leerá

/* Este es un comentario de
   múltiples líneas y no se acabará
   hasta que no cerremos así.... */

    echo "Este es el segundo comentario que se leerá<BR>";
   
# Este es un comentario tipo shell que tampoco se leerá
# Este, tampoco
 
echo ("Aquí el tercer texto visible"); #comentario invisible 

/* Cuidado con anidar
        /* comentarios
            multilinea con estos*/
   al PHP no le gustan */   
?>
     
</body>
</html>
Ver ejemplo9.php Ver ejemplo10.php

Ejecutemos los dos ejemplos. En el caso del ejemplo9 hemos mantenido el código exactamente como se muestra aquí arriba. Como consecuencia de haber anidado comentarios nos dará un error al ejecutarlo. Esto es una muestra de la importancia que tiene cuidar estrictamente ese aspecto.

En el ejemplo10 hemos quitado el /* que va delante de «comentarios» y el */ que va después de «multilínea con estos» (marcado en magenta en el código fuente). Ya no hay comentarios anidados y ya funciona correctamente.

  ¡Cuidado!  

Si tu sistema operativo es Ubuntu es muy probable que en vez de los mensajes de error comentados en los ejemplos anteriores solo visualices una página en blanco. Ello es debido a la configuración por defecto de la directiva display_errors de php.ini. En este enlace tienes información relativa a la configuración de las directivas de error.