Una de las características más importantes de cualquier lenguaje de programación es la habilidad de agregar comentarios a tu código. Los comentarios son piezas de texto que no son ejecutadas como parte del código, pero que son extremadamente útiles para ayudar a los desarrolladores a entender la función de determinadas secciones del código.
En PHP, hay dos formas correctas de iniciar un comentario de una línea. La primera es utilizando dos barras diagonales //
.
// Esto es un comentario
echo "Hola, Mundo!";
La segunda es utilizando el símbolo de número #
.
# Esto es un comentario
echo "Hola, Mundo!";
Cualquiera de estas dos opciones hará que PHP ignore el resto de la línea, permitiéndote agregar notas o referencias sin cambiar la ejecución del código.
Es importante destacar que el uso de comentarios no se limita a "etiquetar" tu código. En la programación moderna, los comentarios son muy utilizados para generar documentación automática, marcar secciones de trabajo en progreso o funcionalidades futuras y mucho más.
En cuanto a las mejores prácticas, es aconsejable usar comentarios de manera prudente. Mientras que son útiles para explicar el propósito y la funcionalidad de una sección de código grande, también es cierto que un código legible y bien estructurado debería ser "auto-explicativo". Recuerda, el mejor comentario es el que no necesitas.
Por último, debes tener en cuenta que las formas !!
y \/
no son válidas para iniciar comentarios en PHP, intentar hacerlo producirá un error de sintaxis.