PHPDoc的参数必须是实现接口的特定类

Question

如何为必须是特定类（或子类）并且必须实现接口的参数编写PHPDoc？

class Animal{
    public function name();
}

interface IsCute{
    public function cuddles();
}

/**
 * @param Animal<IsCute> $animal must be a subclass of Animal and also implements IsCute
 */
function cuddlyAnimal(Animal $animal){
    $animal->cuddles();
}

在上面的示例中，我有一个AnimalClass，其中包含许多潜在的子类，如Dog，Cat，Salmon，Bluejay。

我的课程结构如下：

• Animal
  • Mammal
    • Dog implements IsCute
    • Cat implements IsCute
  • Fish
    • Salmon
  • Bird
    • Bluejay implements IsCute

Dog ， Cat和Bluejay实现IsCute ， Salmon则没有。 我想要一个cuddlyAnimal的PHPDoc，它需要Animal类和IsCute接口。

Answer 1

尝试这个：

/**
 * @param IsCute|Animal $animal must be a subclass of Animal and also implements IsCute
 */
function cuddlyAnimal(IsCute $animal){
    $animal->cuddles();
}