类的方法返回$this,应该如何写注释?
环境:PHP 8.0
class User
{
private $name;
/**
* @rertun static
*/
public function setName(): static //请问这里应该是static?self?User?
{
$this->name = 'tom';
return $this;
}
}
关于 LearnKu
user
如果你的 class 不是
final的,方法也不是private的,那就推荐写static。其他情况下,更推荐
self,至于User不太推荐,因为如果后续可能要修改类名的话,你就必须要一起改,虽然现在 IDE 都能帮你解决了。另外,方法签名如果声明了返回值,注释里面就不应该重复写了,除非方法签名有不支持的类型,比如 array-shape、泛型 等
static
static