如何在 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) 的錯誤。所以現在必須是這樣。