Как считать комментарий в PHP?

Не знаю где в WP комментарии ставятся. Но в PHP есть такое:

<?php
/** 
* A test class
*
* @param  foo bar
* @return baz
*/
class TestClass { }
$rc = new ReflectionClass('TestClass');
var_dump($rc->getDocComment())
?>

Результат:

/** 
* A test class
*
* @param  foo bar
* @return baz
*/

Пример из документации getDocComment

Открыть файл php как обычный файл и прочитать иформацию из него, строка за строкой. WordPress так и делает.

Вот код для считывания текущего файла php в массив

$lines = file( __FILE__ );

Дальше с этим массивом строк можно делать что угодно.