工厂方法的正确 phpdoc @return

【问题标题】：proper phpdoc @return for factory method工厂方法的正确 phpdoc @return
【发布时间】：2011-06-02 13:55:07
【问题描述】：

我很好奇如何记录以下场景。想象一组类：

abstract class Personality {}
class Me extends Personality {}
class Myself extends Personality {}
class Irene extends Personality {}

如果我正在编写工厂式方法来实例化并返回 Personality 类的子类，我将如何正确记录 @return？

@return mixed  A "Personality" subclass object

或

@return Personality  A "Personality" subclass object

【问题讨论】：

标签： php phpdoc

【解决方案1】：

@return Personality A "Personality" subclass object

是最好的。 IDE 将为您提供 Personality 类的自动完成属性。

【讨论】：

有没有办法指定工厂方法返回调用工厂方法的类的实例？（例如Irene::create()）
@crishoj 有：@return static。这不在 PhpDocumentor 文档中，但受到 PhpStorm、NetBeans 和可能的其他编辑器的支持。