Re: docBlock Parser RFC
| From: | Christian Kaps | Date: | Thu, 16 Sep 2010 21:23:30 +0000 |
| Subject: | Re: docBlock Parser RFC | ||
| References: | 1 | Groups: | php.internals |
| Request: | Send a blank email to internals+get-49737@lists.php.net to get a copy of this message | ||
Am 16.09.2010 22:56, schrieb Chad Fulton:
> Hello,
>
> Based on comments from the annotations thread, I have created a
> docBlock parser RFC at http://wiki.php.net/rfc/docblockparser
>
> This RFC does not deal with annotations per se, but only with the idea
> of adding a function to the Reflection extension which would parse
> docBlocks according to a set docBlock syntax into a simple associative
> array containing three elements: short description, long description,
> and an array of tags.
>
> This is only meant to aid meta-data retrieval for classes and does not
> automatically instantiate anything objects.
>
> The RFC was meant to conform to existing convention on the formatting
> of docBlocks - so one major way to improve it would be to note any
> inconsistencies with accepted practice.
>
> Feel free to improve in any other way as well, of course.
>
> Thanks,
> Chad
>
Hi Chad,
the RFC looks for me like a built-in PHPDocumentor parser. This can be
useful. The problem for me is that I cannot parse the file level doc
block. What is with tags like @Validator('blabla'). I cannot find an
example for this scenario.
Greetings,
Christian