Support for array type in ParamConverter

[jingu]

• Arura.Sqlの Array Quoting に対応するためにParamConverterが配列を扱えるように変更しました。
• インターフェイスの名前は ToScalarInterface となっておりarrayだとスカラーとは厳密には呼べないですが、後方互換性を考えてそのままにしてあります。 ToPrimitiveInterface::toPrimitive にすると名前的にも良さそうですが・・・。

例）

SELECT * FROM article WHERE status IN (:status)

<?php
interface ArticleInterface
{
    #[DbQuery(id: 'article_list')]
    public function list(StatusList $status): array;
}

<?php

readonly class StatusList implements ToScalarInterface
{
    public function __construct(private array $statusList)
    {
    }

    public function toScalar(): array
    {
        return $this->statusList;
    }
}

<?php

$articles = $this->article->list(new StatusList(['draft', 'public']));

案2)
ToScalarList インターフェイスを新設

<?php
interface ToScalarListInterface
{
    /** @return array<scalar> */
    public function toScalarList(): array;
}


readonly class StatusList implements ToScalarListInterface
{
    public function __construct(private array $statusList)
    {
    }

    public function toScalarList(): array
    {
        return $this->statusList;
    }
}

[koriym]

Array Quoting に対応

いいですね！

名前が問題ですね。toScalarでは確かにおかしいのですが、arrayはPrimitiveではないようです。
スカラーと配列を総称する名前はないようです。 ... 🤔

BCについては1.0のタイミングで破壊するのも可能ですが、互換性を保って(deprecate)追加するという手もありますね。

[koriym]

候補

TypeConverterInterface
TypeShifterInterface
TypeCasterInterface

総称する名前がないのならそれぞれ何にという型は含まず、型を変更するという意味にしてはどうかと思いました。

[jingu]

ありがとうございます。

総称する名前がないのならそれぞれ何にという型は含まず、型を変更するという意味にしてはどうかと思いました。

なるほど。確かに。