Parsing docblocks made easy

1.5.0 2014-06-14 16:38 UTC


Build Status

Block makes parsing PHP DocBlocks easier.

Simple, documented and fully tested. PHP 5.4 is required.


Using Composer: composer require "ilya/block:~1".


Imagine you have the following code:

class Foo {

     * The Bar.
     * @var integer
    protected $bar;

     * The Baz.
     * @var string
    public $baz;

     * Do Amaze.
     * @param string $amaze
     * @return void
    private function wow($amaze)



First, instantiate Block, like so: $block = new Block\Block(new Foo);.

Now you can begin to inspect the docblocks using these 4 methods available.

  • Block\Comment property(string $name)
  • array properties(integer $filter)
  • Block\Comment method(string $name)
  • array methods(integer $filter)
  • Block\Comment reflector(Reflector $reflector)

Methods property and method will receive a name (as a string) and return an instance of Block\Comment. Methods properties and methods will receive an optional argument $filter and return an array of Block\Comment instances.

If you are wondering what that $filter thing is, take a look at the example:

$block->methods(ReflectionMethod::IS_PUBLIC); // only fetch public methods

// only fetch private AND protected properties
$block->properties(ReflectionProperty::IS_PRIVATE | ReflectionProperty::IS_PROTECTED);

Ok, so now that you have an instance (or many of them) of \Block\Comment, what kind of actions can you perform?

  • convert the instance to a string: $comment->getComment(). Note that (string) $comment would work too!
  • split it into lines: $comment->getLines().

Let's review the second option.

Calling the getLines() method will return an array, each element of which is an instance of \Block\Line.

Here's what it offers:

  • boolean isTag(void) - determine whether the line contains a tag: will be true for @param int $speed and false for My desc.
  • string getLine(void) - get the line itself, as a string, note that (string) $line would also work.
  • array tokenize(void) - split the line into "tokens" - e.g @param int $speed will be represented as ['@param', 'int', '$speed']. All white spaces are ignored.
  • string stripTag(void)

So that's it, hopefully you now can start to use Block in your projects.


Block is licensed under the MIT license.