在 PHP 中模拟一个泛型类

Question

我正在尝试实现一个处理查询的结果类。所以，简单地说，你会有这样的功能：

function all();
function first();
function paginate(int $perPage, int $pageNo = 1);

这很好用，问题是当在多个不同的查询类中使用相同的结果类时，IDE 无法知道返回类型。示例：

UserQuery->results()->all() 将返回一个用户实体数组。

UserQuery->results()->first() 将返回单个用户实体。

在某些语言中，您有泛型，这意味着我可以在 UserQuery 类中使​​用 Results<User>，然后我的 Results 类可以分别返回 T[] 和 T。

我的一个想法是将一个空实体作为构造函数传递给 Results 类，然后尝试使用该属性作为返回类型，但我想不通。有什么解决方法吗？我要解决的主要问题是 IDE 自动完成和分析，因此纯 phpDoc 解决方案非常适合我的用例。

我能想到的唯一其他解决方法是必须为每种实体类型编写一个单独的 Results 类，这会很累。

Answer 1

我认为没有办法完全按照您的描述进行操作，但在类似情况下，我建议为每个结果类型使用代理类，并使用 phpDocumentor 的@method 记录正确的返回类型。该解决方案具有附加价值，可以为任何特定类型的结果修改和扩展提供一个很好的位置。这是一个例子：

abstract class Results
{
    function all(): array
    {
    }

    function first()
    {
    }

    function paginate(int $perPage, int $pageNo = 1): array
    {
    }
}

class User { }

/**
 * @method User[] all()
 * @method User first()
 * @method User[] paginate(int $perPage, int $pageNo = 1)
 */
class UserResults extends Results { }

class UserQuery
{
    /**
     * @var UserResults
     */
    private $results;

    public function __construct()
    {
        $this->results = new UserResults();
    }

    public function results(): UserResults
    {
        return $this->results;
    }
}

$userQuery = new UserQuery();
$test = $userQuery->results()->all();