Inline-Dokumentation für Klassen sollten entsprechend der PHPDoc Konvention erfolgen (ähnlich Javadoc). Mehr Information über PHPDoc finden Sie hier: http://www.phpdoc.de/
Weitere Kommentare, welche nicht der Klassendokumentation dienen, werden nachdrücklich empfohlen. Eine generelle Faustregel ist: Wenn Sie auf ein Stück Code blicken und denken "Wow, ich möchte das nicht versuchen und beschreiben", dass Sie es auf jeden Fall kommentieren sollten, bevor Sie vergessen, wie es funktioniert.
Kommentare im Stil von C (/* */) und C++ (// ) sind zu verwenden, während Kommentare im Stile von perl/shell (#) zu vermeiden sind.