PHP DocComment注释结构和解析

我想使用DocComment为属性、类和函数定义一些元数据，比如用更高级的语言进行注释。

这些数据由一些标量和数组变量组成，例如

<?
/** type=set, options=[value1, value2, value3] **/
public $state;
?>

我想不出有什么好的结构可以在这里使用。

我想在用&，但它不适用于数组部分（在我的示例中，选项）。

这是一个java注释的例子，它包括键值对的可选列表。使用java注释是一种很好的做法，但是如何编写一个有效的解析器呢？

@Author(first = "Oompah", last = "Loompah")

对于快速、易于实现和人类可读的结构和解析方法，任何好的建议都将不胜感激。