Los armazones del PHP tienen generalmente documentación de la clase, pero usted la genera usted mismo de la fuente si usted quiere.
Mi herramienta preferida es doxygen
(http://www.doxygen.org), solamente phpDocumentor
(http://www.phpdoc.org) es también agradable.