PHPStorm:对象集合的正确 PHPDoc？

Question

我正在使用 PHPStorm IDE，在运行代码检查时遇到了麻烦。

我有一个返回对象集合的方法。 Collection 本身是一个对象，它有自己的方法，并实现了 Traversable接口(interface):

class Repository
{
    public function findByCustomer(Customer $user)
    {
        // ...
        return new Collection($orders);
    }
}

如果我记录 findByUser() 以返回一个 Collection，代码检查理解该对象的方法，但不理解该集合包含哪些对象:

/**
 * @return Collection
 */
public function findByCustomer() { ... }

如果我记录 findByUser() 以返回 Order 对象的集合，代码检查现在了解集合中的内容，但不了解 上的方法集合本身:

/**
 * @return Order[]
 */
public function findByCustomer() { ... }

有没有办法同时指定两者，类似于 Java 的语法？

/**
 * @return Collection<Order>
 */
public function findByCustomer() { ... }

Answer 1

您可以将它们(两种类型)组合在一起。在某些情况下可能并不理想，但可以工作，您可能认为它比通过 @var PHPDoc 注释手动指定类型更好。

/** @return Collection|Order[] */