PHPdoc: 如何记录链式方法？

Question

如何正确使用PHPdoc来记录类中可链接方法，就像下面的示例中所看到的-什么是正确的用法？

class myClass {


    /**
    * @return myClass
    */
    function one()
    {
        return $this;
    }

    /**
    * @return self
    */
    function two()
    {
        return $this;
    }

    /**
    * @return $this
    */
    function three()
    {
        return $this;
    }

}

- Industrial

Answer 1

/**
* @return myClass
*/

我不是phpDoc专家，但这是Zend框架中的做法。所以我认为它是可靠的。

- yokoloko

---

这个选项通常效果最佳，特别是在IDE自动完成方面。 - ashnazg

Answer 2

我更喜欢

/**
* @return $this
*/

- xdazz

---

那是否有被PHPDoc支持？在我看来，那只是运行时而不是静态代码文档。 - hakre