如何在CakePHP 3.7中对自定义Finder的结果进行分页？

我之前也碰到过类似的情况，核心问题其实有两个：你的自定义Finder返回了数组而非ORM Query对象，以及不知道如何给Finder传递参数让分页组件识别。下面一步步来解决：

第一步：修正自定义Finder的返回值 #

CakePHP的分页组件是基于ORM Query对象来处理分页逻辑的，你现在返回$query->toArray()把结果转成了数组，分页组件根本没法对数组做分页处理，所以会直接返回全部数据。

打开你的RevisionFiltersTable.php，修改findRegulatoryNotifications方法，去掉toArray()，直接返回Query对象：

public function findRegulatoryNotifications(\Cake\ORM\Query $query, array $options)
{
    // 从$options中获取控制器传递过来的参数
    $param1 = $options['param1'] ?? null;
    $param2 = $options['param2'] ?? null;

    // 这里写你的查询逻辑，比如添加条件、关联、排序等
    $query->where([
        'RevisionFilters.some_field' => $param1,
        'RevisionFilters.another_field >' => $param2
    ])
    ->order(['RevisionFilters.created' => 'DESC']);

    // 关键：直接返回Query对象，不要转数组！
    return $query;
}

第二步：控制器中配置分页并传递参数 #

有两种配置方式，根据你的参数是否动态来选择：

方式一：Action内动态配置（推荐用于参数动态变化的场景） #

如果你的参数是从URL、表单等动态获取的，直接在Action里设置分页规则：

public function regulatoryNotifications()
{
    // 1. 获取要传递给Finder的参数（比如从URL查询串获取）
    $param1 = $this->request->getQuery('param1');
    $param2 = $this->request->getQuery('param2');

    // 2. 配置分页规则，指定自定义Finder和参数
    $this->paginate = [
        'finder' => [
            // 键是Finder名称（去掉find前缀，小写驼峰/下划线都支持）
            'regulatoryNotifications' => [
                'param1' => $param1,
                'param2' => $param2
            ]
        ],
        // 可选：设置每页条数、排序规则等
        'limit' => 15,
        'order' => [
            'RevisionFilters.id' => 'DESC'
        ]
    ];

    // 3. 调用分页方法，传入对应的Table实例
    $notifications = $this->paginate($this->RevisionFilters);

    $this->set(compact('notifications'));
}

方式二：控制器初始化时配置默认值 #

如果你的Finder参数有固定默认值，或者想全局配置这个Table的分页规则，可以在initialize方法里设置：

public function initialize()
{
    parent::initialize();
    $this->loadComponent('Paginator'); // 确保加载分页组件

    // 为RevisionFiltersTable配置默认分页规则
    $this->paginate = [
        'RevisionFilters' => [
            'finder' => [
                'regulatoryNotifications' => [
                    'param1' => 'default_value',
                    'param2' => 50
                ]
            ],
            'limit' => 20
        ]
    ];
}

// 在Action中直接调用分页，也可以随时覆盖默认参数
public function regulatoryNotifications()
{
    // 可选：如果需要临时修改参数，在这里重新设置
    // $this->paginate['RevisionFilters']['finder']['regulatoryNotifications']['param1'] = 'new_value';

    $notifications = $this->paginate($this->RevisionFilters);
    $this->set(compact('notifications'));
}

额外注意事项 #

• Finder的第二个参数$options就是你在控制器中传递的参数数组，要确保键名对应；
• 分页后的结果是Cake\Datasource\ResultSetInterface实例，用法和数组类似，还自带分页元数据（总条数、当前页等）；
• 前端可以用$this->Paginator助手生成分页链接，比如<?= $this->Paginator->numbers() ?>。

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