Я делаю какую-то самодельную автоматизированную документацию, так как у меня есть кодовая база, которая не очень стандартна в своем макете, и мне было интересно, как лучше всего было бы прочитать файл PHP и захватить содержимое блока комментариев , Единственный способ, которым я могу подумать - это открыть файл и прочитать его построчно, но подумал, что, возможно, была какая-то встроенная магия, которая могла бы анализировать документ для меня, подобно функциям Reflection.
Основная схема каждого файла выглядит следующим образом:
<?php // $Id$
/**
* Here is this script's documentation, with information in pseudo-javadoc
* type tags and whatnot.
*
* @attr something some information about something
* @attr etc etc etc
*/
// rest of the code goes here.
Важно отметить, что в этих файлах не определены функции или классы. Комментарии относятся к сценарию в целом.