В PHP есть два способа оформить комментарии: 2

1. Однострочные комментарии. 2 Перед ними ставятся два символа косой черты (//). 2 Пример: . 2
2. Многострочные комментарии. 2 Они обернуты разделителями /* и /. 2 Знак / обозначает начало блока комментариев, а / указывает на его конец. 2 Пример: Это многострочный блок комментариев */ ?>. 2

Для коротких комментариев лучше использовать однострочные, а для длинных — многострочные. 35

Также для документирования функций и методов в сложных проектах используется DocBlock. 1 В определённой форме записываются название метода или функции, их описание, входные параметры и то, что они возвращают. 1