Обычно я помещал документацию для интерфейса (\param, \return) в.h файле и документации для реализации (\details) в .c/.cpp/.m файле. Doxygen группирует все в документации функции/метода.
Вы можете использовать XMLReader:
$reader = new XMLReader();
$reader->open('xmlfile.xml');
$reader->setSchema('schemafile.xsd');
while($reader->read());
$reader->close();