Una de las buenas practicas que se debe aplicar cuando se crea codigo de programacion en php ya sea para el uso que le des es usar los comentarios estos nos ayudaran a entender un poco el flujo que se viene creando en ciertos apartados como por ejemplo las variables , las funciones que le dan a su codigo.
A continuacion se muestra una imagen de como realizar estos comentarios. Para el primer caso se coloca 2 barras "//" para hacer el comentario sobre una linea esto tambien sirve para comentar parte de tu codigo y pueda quedar omitido. Otra opciciones colocar la barra junto con el asterisco "/*" esto hace referencia a comentar mas de 1 linea de igual forma puede aplicarse dentro de tu codigo para que quede omitido y para cerrar esto se coloco lo inverso primero el asterisco y luego la barra "*/".
NOTA: Los comentarios no son visibles dentro del sistema , pagina web, etc. que estes desarrollando solamente es algo interno que se logra visualizar cuando ves el codigo directamente.