который является правильным способом документировать константы класса для phpDoc? Я прочитал руководство, но я ничего не могу найти о них
Я уверен, что вы можете использовать @const
, хотя я не могу найти ни одной английской документации. Здесь есть немецкий пример. Он показывает define
а не константы классов, но IIRC синтаксис тот же.
Константам нужен только док-блок, содержащий описание. Никакой специфический тег не нужен. Сам анализатор кода идентифицирует константы и отображает их как таковые в сгенерированной документации ( вот пример ).