PhpDoc: 受保护的属性

4

是否可以使用PhpDoc声明protectedprivate类@property?

/**
  * Class Node
  * @package app\models
  * @property string $name
  */
class Node
{

}

1
我可能错了,但是为什么要说这个类有一些属性是无法访问的呢? - Justinas
3
您可能希望记录内部魔法方法/属性。 - igorsantos07
1个回答

4

我不这么认为。对于@property,即使是只读或只写,public也是暗示的。这些标签的重点在于记录无法推断的接口。私有/受保护的变量实际上是类内部的,因此只与子类相关,应该编写成如果它们已经知道这一点。但是,在声明之前仍然可以留下普通的文档块。


如果有一些原因需要突出显示一个实际上不是公共的魔术属性,您可以使用@internal标记来解释为什么该属性值得突出显示。 - ashnazg

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接