Zend Framework 3+Doctrine 2分页：限制总记录数为500的实现问题

要实现“无论搜索结果有多少，分页最多只展示500条记录”的需求，我们可以通过两种方式来处理，根据你的性能需求选择即可：

方法一：直接限制查询结果，使用数组分页器 #

这种方式简单直接，适合数据量不大的场景，会一次性取出最多500条符合条件的记录，再基于这些数据做分页：

// 获取符合搜索条件的记录，最多取500条
$limitedRegistros = $this->regService->getRegisters($searchParameters)
    ->setMaxResults(500)
    ->getResult();

// 使用Zend的数组分页适配器
$adapter = new \Zend\Paginator\Adapter\ArrayAdapter($limitedRegistros);
$paginator = new \Zend\Paginator\Paginator($adapter);

// 配置分页参数
$paginator->setDefaultItemCountPerPage(20);
$paginator->setCurrentPageNumber($page);

return new ViewModel([
    'registros' => $paginator
]);

注意点： #

• 这里假设getRegisters返回的是Doctrine的Query对象，如果你的服务层返回的是已执行的结果集，需要调整服务层方法，先返回Query对象再添加setMaxResults限制。
• 这种方式会一次性加载500条记录到内存，如果单条记录数据量很大，可能会有性能问题，此时推荐用方法二。

方法二：自定义Doctrine分页适配器，按需加载数据 #

这种方式会保留Doctrine分页的按需加载特性，同时强制总记录数不超过500，性能更优：

第一步：创建自定义适配器类 #

在你的项目中新建一个适配器类，继承Zend的DoctrineAdapter，重写count方法来限制总记录数：

namespace Your\Namespace;

use Zend\Paginator\Adapter\DoctrineAdapter;
use Doctrine\ORM\Tools\Pagination\Paginator as ORMPaginator;

class LimitedDoctrineAdapter extends DoctrineAdapter
{
    private int $maxTotalRecords;

    public function __construct(ORMPaginator $paginator, bool $fetchJoinCollection = true, int $maxTotalRecords = 500)
    {
        parent::__construct($paginator, $fetchJoinCollection);
        $this->maxTotalRecords = $maxTotalRecords;
    }

    /**
     * 重写count方法，返回实际记录数和最大值的较小值
     */
    public function count(): int
    {
        $originalTotal = parent::count();
        return min($originalTotal, $this->maxTotalRecords);
    }
}

第二步：在控制器中使用自定义适配器 #

// 获取搜索对应的Query对象
$registrosQuery = $this->regService->getRegisters($searchParameters);
// 限制查询最多返回500条记录
$registrosQuery->setMaxResults(500);

// 初始化Doctrine ORM分页器
$ormPaginator = new \Doctrine\ORM\Tools\Pagination\ORMPaginator($registrosQuery, false);
// 使用自定义的限制适配器，传入最大总记录数500
$adapter = new \Your\Namespace\LimitedDoctrineAdapter($ormPaginator, false, 500);

$paginator = new \Zend\Paginator\Paginator($adapter);
$paginator->setDefaultItemCountPerPage(20);
$paginator->setCurrentPageNumber($page);

return new ViewModel([
    'registros' => $paginator
]);

注意点： #

• 必须同时设置Query的setMaxResults(500)，否则即使适配器限制了总记录数，Doctrine还是会查询所有符合条件的记录，失去分页按需加载的意义。
• 这种方式只会加载当前页需要的记录（比如每页20条），内存占用更低，适合大数据量场景。

两种方法都能实现你的需求，根据你的实际业务场景选择即可。

内容的提问来源于stack exchange，提问作者Rbotana