Shopware 6中已废弃addExtension方法的替代方案咨询

根据Shopware 6官方开发文档说明，向Storefront的pagelet添加自定义数据的标准实现方式是调用addExtension方法，官方给出的示例代码如下：

use Shopware\Storefront\Pagelet\Footer\FooterPageletLoadedEvent;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

public function addActiveProductCount(FooterPageletLoadedEvent $event): void
{
  $event->getPagelet()->addExtension('product_count', $productCountResult);
}

实际开发中出现了不符合文档预期的提示：v6.4.13.0版本的官方升级说明中，完全没有提及addExtension方法被废弃，但IDE会持续提示该方法已废弃，具体提示信息如下：

方法 'addExtension' 已废弃
方法签名：public function ExtendableTrait::addExtension(string $name, ?Struct $extension) void
方法功能：向类存储中添加新的扩展结构体，传入的名称作为唯一标识符同步存储。
废弃版本标记：5.6.0
实现接口：ExtendableInterface::addExtension
声明位置：Shopware\Core\Framework\Struct\ExtendableTrait
源码路径：development/vendor/shopware/platform/src/Core/Framework/Struct/ExtendableTrait.php

问题排查进展 #

最初排查认为提示原因是方法第二个参数$extension不再允许传入null值，开发者特意补充了非空校验逻辑，确保传入参数不会为null，调整后的代码如下：

if ($productCountResult) {
    $event->getPagelet()->addExtension('product_count', $productCountResult);
}

但实际验证后发现，即使前置if判断已经完全保证$productCountResult非空，addExtension方法依然被IDE标记为废弃。

待确认诉求 #

• 请官方明确addExtension方法对应的正式替代方案，以及相关说明文档的位置
• 如果addExtension属于和此前EntityRepository同类的误标记废弃情况，请相关维护人员移除该方法上错误的废弃标记

内容的提问来源于stack exchange，提问作者Ingo Steinke