AD

¿Ya dominas lo básico? Un curso estructurado de PHP es la vía rápida para dar el salto.

Ver cursos de PHP en Udemy

Enlace de afiliado. No te cuesta nada extra.

🐘Lecciones de PHP
Lección 17 / 68

Escribir comentarios

En esta lección dejarás notas en el código para quien lo lea después.

PHP admite // y # para una línea, /* ... */ para varias, y /** ... */ para los bloques de documentación PHPDoc.

El código de ejemplo muestra las formas junto a código real.

PHPDoc es importante en este ecosistema: con @param y @return, el editor conoce los tipos y avisa de errores antes de ejecutar. En código antiguo sin declaraciones de tipo, esos comentarios son a veces la única información de tipos que existe.

Sobre qué escribir: un comentario que repite lo que dice la línea sobra y envejece mal. El valioso explica por qué — qué alternativa se descartó, qué requisito obligó a esa solución. Eso es lo que no se deduce leyendo el código.

📖 Código de referencia
✍️ Tu código
Escribe tu código y pulsa «Ejecutar»

🧪 Este sitio no puede compilar ni ejecutar PHP directamente, así que comprueba al instante si lo que escribiste coincide con el código de referencia (la corrección ocurre por completo en tu navegador; no se envía nada a ningún servidor).

🔗 El mismo tema en otros lenguajes

Mira cómo se escribe lo mismo en otro lenguaje.

Espacio publicitario (banner)
Espacio publicitario (en el artículo)