15

在一些现有代码上，我有以下语句（经过相当长的查询构建练习）：

return $statement->fetchAll(
    DBAL\FetchMode::CUSTOM_OBJECT,
    PublishedLead::class
);

这有效（到目前为止），但我现在看到两者fetchAll()和FetchMode自 DBAL 2.11 以来已弃用：

// ResultStatement::fetchAll()
/* 
 * @deprecated Use fetchAllNumeric(), fetchAllAssociative()
 * or fetchFirstColumn() instead.
 */

// FetchMode
/* 
 * @deprecated Use one of the fetch- or iterate-related 
 * methods on the Statement
 */

为了使我的代码尽可能向前兼容，如何编写此代码以获取水合到自定义对象中的结果？我是否必须根据结果编写自定义补水逻辑，或者 DBAL 可以为我做这件事吗？

4

1 回答 1

13

DBAL 3

API 与 DBAL 3 发生了一些重大变化。值得注意的是，对于这个答案，语句不再用于存储和访问结果，因此不再可能执行语句然后简单地循环它。与 execute 不同Statement，Result返回的对象$statement->execute()不是 is Traversable，因此下面建议的代码必须更改为$result->fetchAllAssociative在循环之前显式调用（或在 foreach 语句中），但在其他方面仍然兼容（该变量在该点具有不同的类型） ：

function getDatabaseResult(): Generator { // change return type hint, if applicable
    // rest of your function/method
    $result = $statement->execute(); // or ->execute($values);
    foreach ($result->fetchAllAssociative() as $row) {
        yield PublishedLead::fromArray($row);
    }
}

DBAL 2

据我通过阅读 DBAL 源代码可以看出，通常不推荐使用 fetch 模式，而应使用提供的辅助方法，这将结果限制为数字或关联数组。

这意味着将结果编组到您自己的类中的过程现在可能应该在 DBAL 之外处理。这可能是一个促进使用 Doctrine ORM 的战术决定，或者他们可能只想关注名称中的内容（抽象数据库访问），而忽略与该任务无关的内容。无论哪种方式，编写自定义补水逻辑实际上并不那么复杂，您基本上可以只编写一个 Trait 提供一个静态方法fromArray($data)，该方法遍历数组并设置所有对象属性，然后返回对象（参见相应问题的答案） . 在要从关联数组构建的所有类中使用此特征。

我假设你在某个时候循环遍历你的对象数组，所以你实际上可以把你的函数变成一个生成器。如果您最终使用foreach来遍历您的结果集，这甚至不需要对使用结果的代码进行任何更改。这意味着用以下循环替换您的 return 语句：

foreach ($statement as $row) {
    yield PublishedLead::fromArray($row);
}

如果您不熟悉生成器，这会将您的函数转换为返回 a 的函数\Generator，它可以像 foreach 中的数组一样使用，但实际上并不占用整个内存空间来保存所有数据。相反，只要需要下一个值，就会继续执行原始函数，直到到达下一个 yield 语句，此时返回的 yield 值会立即被使用。

另外，如果您想知道，该语句实际上确实实现了Traversable，因此您可以foreach在获取它之后直接通过它，execute而无需实际调用任何 fetch 方法，这就是我在上面的示例中所做的；$row将是一个关联数组，或者更准确地说，是一个从\PDO::FETCH_BOTH默认获取模式中获得的数组。

这是一个完整的原型：

<?php
// newly created
trait FromArrayTrait {
    public static function fromArray(array $data = []): self {
        foreach (get_object_vars($obj = new self) as $property => $default) {
            $obj->$property = $data[$property] ?? $default;
        }
        return $obj;
    }
}

class PublishedLead {
    use FromArrayTrait; // add this line
    // rest of your class
}

function getDatabaseResult(): Generator { // change return type hint, if applicable
    // rest of your function/method
    // the following 3 lines replace 'return $statement->fetchAll(...);'
    foreach ($statement as $row) {
        yield PublishedLead::fromArray($row);
    }
}

// your actual main code, this is unchanged assuming you already use foreach
foreach (getDatabaseResult() as $lead) {
    $lead->doSomething();
}

显然考虑命名空间并将这些部分放在代码中应有的任何位置。顺便说一句，我稍微改变了fromArray方法，所以它使用默认值，以防数组值为空。如果您确实希望能够用 null 替换默认值，请恢复到上面链接的原始版本。如果您想设置动态属性，即使它们没有在您的类中显式声明，请循环$data而不是get_object_vars()：

    public static function fromArrayDynamic(iterable $data = []): self {
        $obj = new self;
        foreach ($data as $property => $value) {
            $obj->$property = $value;
        }
        return $obj;
    }

当然，如果数组中包含空值，这将用空值覆盖默认值。作为奖励，它与iterable输入兼容，因此它不仅可以使用数组，还可以与 Generators 和 Traversables 一起使用。

于 2020-10-28T11:56:38.787 回答