PHP: Comentarios
¿Para qué sirven los comentarios?
Además del código en los archivos de código fuente, puede haber comentarios. Este texto no es parte del programa. Es útil para los programadores como notas. Con ellos se agregan explicaciones, por ejemplo, cómo funciona el código, qué errores corregir o qué agregar más tarde.
Los comentarios en PHP pueden ser de dos tipos:
- Comentarios de una línea - comienzan con
//. Después de estos caracteres puede seguir cualquier texto, toda la línea no se analizará ni se ejecutará:
<?php
// ¡Por Winterfell!
// ¡Por Lannisters!
// El comentario puede estar en la línea después de algún código
print_r('Soy el Rey'); // ¡Por Lannisters!
- Comentarios de varias líneas - comienzan con
/*y terminan en*/. Entre ellos, cada línea debe comenzar con el carácter*:
<?php
/*
* La noche es oscura y
* está llena de terrores.
*/
print_r('Soy el Rey');
Tarea
Crea un comentario de una línea con el texto: ¡No sabes nada, Jon Snow!.
¿El ejercicio no pasa la prueba, qué debo hacer? 😶
Si te quedaste atascado, es el momento perfecto para hacer una pregunta en las "Discusiones".
* Asegúrate de incluir la salida de las pruebas. Sin ella, es casi imposible entender qué está mal, incluso si muestras tu código. Los programadores tienen dificultades para ejecutar el código en su mente, pero casi siempre es posible entender a dónde mirar a partir del error que recibiste.
Mi código funciona en mi entorno, pero no aquí 🤨
Las pruebas están diseñadas de manera que verifican la solución de diferentes maneras y con diferentes datos. A menudo, una solución funciona con ciertos datos de entrada pero no con otros. Para entender este punto, revisa la pestaña "Pruebas" y presta atención a los mensajes de error, que suelen contener pistas.
Mi código es diferente a la solución del profesor 🤔
Esto es normal 🙆. En programación, una tarea puede tener muchas soluciones diferentes. Si tu código pasa la prueba, cumple con los requisitos de la tarea.
En raras ocasiones, la solución puede estar ajustada para pasar las pruebas, pero esto suele ser evidente.
Leí la lección, pero no entendí nada 🙄
Crear materiales de aprendizaje comprensibles para todos es bastante difícil. Hacemos nuestro mejor esfuerzo, pero siempre hay margen para mejorar. Si encuentras material que no entiendes, describe el problema en las "Discusiones". Es ideal si puedes formular los aspectos que no entiendes en forma de preguntas. Por lo general, necesitamos unos días para hacer mejoras.
Por cierto, tú también puedes contribuir a mejorar los cursos: en la parte inferior hay un enlace al código fuente de las lecciones, que se puede modificar directamente en el navegador.
Definiciones
Comentario — texto en el código del programa que no afecta la funcionalidad y se agrega por los programadores para ellos mismos y sus colegas.
// comentario de una línea/* * comentario de varias líneas * comentario de varias líneas */