我应该使用 @return self、这个还是当前类？

Question

Closed. This question is opinion-based. It is not currently accepting answers.

---

想要改进这个问题？更新问题，以便可以通过编辑这篇文章用事实和引文来回答它。

6 年前已关闭。

Answer 1

PHP 标准建议 (PSR) 目前处于草案中 (PSR-5) 提议 @返回$this 用于指示返回相同的实例。

$this，该类型所应用的元素与给定上下文中的当前类是同一个实例。因此，该类型是 static 的更严格版本，此外，返回的实例不仅必须属于同一类，而且必须属于同一实例。

此类型通常用作实现流畅接口设计模式的方法的返回值。

此表示法目前由 PhpStorm 和 Netbeans 等流行 IDE 使用。

Answer 2

@return Current_Class_Name 肯定会起作用，并且是我更喜欢的。

@return self 也可以在某些程序中正常工作。

@return this 不好，因为这不是类型名。

Answer 3

这个问题很老了，但我只是想分享给大家！

至少对于那些使用 NetBeans 8.1 的人来说。这个表示法使得代码自动完成功能在 IDE 中很好地工作：

/**
 * Method that returns $this instance (using late state binding)
 * @return static
 */
 public function iWillReturnMyself ( ) {
     return $this;
 }

我说至少适用于 NetBeans8.1 用户，但可能也适用于旧版本和/或其他 IDE =]

Answer 4

/**
 * set something
 *
 * @return self
 */
public function setSomething(){
            // ...
    return $this;
}

您可以使用“self”类型作为@param或@return。PHPDoc

建议“self”在对象中引用self。

来源：http://www.phpdoc.org/docs/latest/references/phpdoc/types.html