Symfony 中如何正确注入数组类型参数到服务构造函数-php教程-PHP中文网

Symfony 中如何正确注入数组类型参数到服务构造函数

在 Symfony 5.4+ 中，当服务构造函数参数被声明为 array 类型提示但未显式配置值时，DI 容器会报错；解决方法是为该参数提供默认值（如 = []），或在 services.yaml 中精确绑定数组配置。

在 symfony 5.4+ 中，当服务构造函数参数被声明为 `array` 类型提示但未显式配置值时，di 容器会报错；解决方法是为该参数提供默认值（如 `= []`），或在 `services.yaml` 中精确绑定数组配置。

当你在 Symfony 服务中定义一个 array 类型提示的构造函数参数（例如 $collectionOptions: array），Symfony 的自动装配机制默认不会自动推断该数组应从何处注入——即使你已在 services.yaml 中通过 %parameter% 引用配置项。这是因为 array 是 PHP 原生标量类型，不属于可自动识别的服务类，容器无法凭空决定“该传哪个数组”。

✅ 推荐解决方案：添加默认空数组（最简洁、符合 Symfony 最佳实践）

修改你的构造函数，为 $collectionOptions 提供默认值：

class CollectionQueryFactory implements CollectionQueryFactoryInterface
{
    private array $collectionOptions;

    public function __construct(array $collectionOptions = [])
    {
        $this->collectionOptions = $collectionOptions;
    }

    // ...
}

此时，即使 services.yaml 中未显式配置 arguments，Symfony 也能成功实例化该服务（使用空数组作为兜底）。若你仍希望注入特定配置（如 api_platform.collection.pagination），可保留 YAML 配置：

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

# config/services.yaml
App\Core\Shared\Query\CollectionQueryFactory:
    arguments:
        $collectionOptions: '%api_platform.collection.pagination%'

⚠️ 注意事项：

确保 %api_platform.collection.pagination% 确实是一个纯 PHP 数组（如在 packages/api_platform.yaml 或 services.yaml 中定义的 parameters: 下），而非一个服务 ID 或表达式；
若该参数需动态聚合多个服务（如所有标记为 app.query_option 的对象），才应使用 !tagged_iterator —— 但本例中是静态配置数组，不适用；
不要尝试用 @=service("...") 或 !php/const 等复杂语法绕过类型检查，这会降低可读性与可维护性。