PHPStorm: popraw PHPDoc dla kolekcji obiektów?
UżywamPHPStorm IDE i wpadam w kłopoty, gdy przeprowadzam inspekcję kodu.
Mam metodę, która zwraca kolekcję obiektów. TheCollection
sam jest obiektem, który ma swoje własne metody i implementujePrzemierzalny berło:
class Repository
{
public function findByCustomer(Customer $user)
{
// ...
return new Collection($orders);
}
}
Jeśli dokumentujęfindByUser()
zwrócić aCollection
, inspekcja kodu rozumie metody tego obiektu, ale nie rozumie, jakie obiekty zawiera kolekcja:
/**
* @return Collection
*/
public function findByCustomer() { ... }
Jeśli dokumentujęfindByUser()
zwrócić kolekcjęOrder
obiekty, inspekcja kodu teraz rozumie, co jest w kolekcji, ale nie metody naCollection
samo:
/**
* @return Order[]
*/
public function findByCustomer() { ... }
Czy istnieje sposób na określenie obu jednocześnie, na przykład składni Java?
/**
* @return Collection<Order>
*/
public function findByCustomer() { ... }