README

PHP Docblock 解析器和生成器。一个用于读取和写入 Docblocks 的 API。

警告：从版本 4.0 开始，该库已迁移到 phpowermove 组织，命名空间为 phpowermove\docblock。

安装

通过 Composer 安装

composer require phpowermove/docblock

a) 简单

use phpowermove\docblock\Docblock;

$docblock = new Docblock();

b) 从字符串创建

use phpowermove\docblock\Docblock;

$docblock = new Docblock('/**
 * Short Description.
 *
 * Long Description.
 *
 * @author gossi
 */');

c) 从反射创建

use phpowermove\docblock\Docblock;

$docblock = new Docblock(new \ReflectionClass('MyClass'));

获取标签

$tags = $docblock->getTags();

按名称获取标签

$tags = $docblock->getTags('author');

添加标签

use phpowermove\docblock\tags\AuthorTag;

$author = new AuthorTag();
$author->setName('gossi');
$docblock->appendTag($author);

或使用流畅 API

use phpowermove\docblock\tags\AuthorTag;

$docblock->appendTag(AuthorTag::create()
	->setName('gossi')
);

检查标签存在性

$docblock->hasTag('author');

调用 toString()

$docblock->toString();

或者如果您处于写入上下文，则魔法函数 __toString() 将会处理它

echo $docblock;

请随意分支并提交拉取请求（别忘了测试），我会很高兴将其合并。