PHP类型返回混合内容[关闭]

Question

作为一个好习惯，我已经开始将我的代码转换为类型化属性/类型化函数返回。但我有一个关于混合内容的问题。

我知道返回混合内容通常不是一个好习惯，但我有一种情况是不可避免的。我有一个用作数据容器的类（它具有多种功能，但我会跳到基础知识）：

class Container {
  private array $list = [];

  public set(string $key, ?? $value): void {
    $this->list[$key] = $value;
  }

  public get(string $key): ?? {
    return $this->list[$key];
  }
}

我已跳过所有检查和所有其他功能。关键是list 可以容纳任何类型的东西（int、boolean、string、其他类对象...）那么我应该如何处理呢？

我知道 PHP 8 将有联合返回类型，所以至少我可以缩小范围（int|float|string...），但由于这是相当新的，我不知道我应该怎么做。

Answer 1

保持简短。你不能用 PHP7 做到这一点。正如你已经说过的，联合类型声明将在当天尚未发布的 PHP8 中提供。

另一种方法是为您正在使用的每种类型编写集合。您可以使用接口来识别类型。在完美世界中，一切都是对象，如下例所示。

首先是集合。

<?php
declare(strict_types=1);
namespace YourApp\Model;

use InvalidArgumentException;
use SplObjectStorage;

class TeamCollection extends SplObjectStorage
{
    public function attach(object $object, $data = null): void
    {
        if ($object instanceof Team) {
            throw new InvalidArgumentException(sprintf(
                'The given object is not a team. %s given.',
                get_class($object)
            ));
        }

        parent::attach($object, $data);
    }
}

这是 Team 类的集合。仅在将某些内容附加到此集合时才接受 Team 类。否则会抛出异常。由于继承，您不能向 Team 键入提示对象，因为这会引发另一个错误。 SplObjectCollection 类将$object 参数定义为对象类型。你不能覆盖它。因此，如果给定了 Team 类，我们可以检查 attach 方法。

<?php
declare(strict_types=1);
namespace YourApp\Model;

use YourApp\Model\TeamMemberCollection;
use YourApp\Model\TeamMember;

interface Team
{
    public function getName(): ?string;
    public function setName(string $name): self;
    public function addMember(TeamMember $member): self
    public function getMembers(): TeamMemberCollection;
}

接口定义了团队所需的方法。现在我们可以编写一个 Team 类了。

<?php
declare(strict_types=1);
namespace YourApp\Model;

class SoccerTeam implements Team
{
    protected TeamMemberCollection $members;
    protected string $name;

    public function __construct()
    {
        $this->members = new TeamMemberCollection();
    }

    public function getName(): ?string
    {
        return $this->name;
    }

    public function setName(string $name): self
    {
        $this->name = $name;
        return $this;
    }

    public function addTeamMember(TeamMember $member): self
    {
        $this->members->attach($member);
        return $this;
    }

    public function getMembers(): TeamMemberCollection
    {
        return $this->members;
    }
}

这个团队类的例子可以转移到 TeamMember 类。原则上，它会完全像这样。

现在让我们看看我们的团队收藏以及它是如何工作的。

$teams = new TeamCollection();

$team = (new SoccerTeam())
    ->setName('Borussia Dortmund');

$teams->attach($team);

这是一个正面的例子。由于 SoccerTeam 类实现了 Team 接口，它会被团队集合所接受。集合本身检查是否附加了 Team 实例。任何其他情况都会导致异常。