如何在 PHP 8.1 中的 Symfony 实体中声明类型化集合

Question

我收到来自 PHPStan 的错误：

Property App\Entity\Product::$productArticles type mapping mismatch: property can contain Doctrine\Common\Collections\Collection but database  
         expects Doctrine\Common\Collections\Collection&iterable<App\Entity\ProductArticle>

我的变量声明：

#[ORM\OneToMany(mappedBy: 'product', targetEntity: ProductArticle::class)]
    /** @var  Collection<int, ProductArticle> */
    private Collection $productArticles;

如何同时使用：注释来声明 ORM 变量和 PHPDoc 注释来声明 Collection 类型？

Answer 1

PHPDoc 需要位于属性上方。

class Foo
{
    /** @var  Collection */
    #[ORM\OneToMany(mappedBy: 'product', targetEntity: ProductArticle::class)]
    private Collection $productArticles;
}

这是 PHPStan 使用的解析器库 (nikic/php-parser) 的错误。所以现在必须是这样。