CakePHP3迁移：Table类中无法用func_get_arg()获取分页参数怎么办？

问题根源 #

CakePHP3对分页机制做了重构，Table类的paginate方法签名和CakePHP2完全不同：

• CakePHP2中Model::paginate接收多个分散的参数（如limit、page、extra等）
• CakePHP3中Table::paginate仅接收两个参数：第一个是QueryInterface对象，第二个是包含所有分页配置的数组

你之前依赖固定索引调用func_get_arg()的方式，自然无法获取到正确参数。

解决步骤 #

1. 修正Controller中的分页调用方式 #

原来的调用逻辑错误，应该直接将Table实例和分页配置传给Paginator的paginate方法，由Paginator触发Table的paginate方法：

class TopController extends AppController {

  public function showTop() {
    $paginateSettings = array(
      'limit' => 5,
      'extra' => array(
        'data' => 'test', 
      ),
    );

    $topRawTable = TableRegistry::get('TopRawSql');
    // 直接传递Table实例和配置，由Paginator调用Table的paginate
    $pages = $this->Paginator->paginate($topRawTable, $paginateSettings);
  }
}

2. 调整Table中paginate方法的参数获取逻辑 #

通过func_get_arg()获取第二个参数（分页配置数组），再从中提取需要的参数值，保留func_get_arg()的使用：

class TopRawSqlTable extends Table {

  public $useTable = false;
  
  function paginate()
  {
    // 获取第二个参数：包含所有分页配置的数组
    $settings = func_get_arg(1);
    
    // 从配置数组中提取所需参数
    $extra = $settings['extra'] ?? null;
    $limit = $settings['limit'] ?? null;
    $page = $settings['page'] ?? null;

    // 执行你的自定义查询逻辑
    // 示例：计算偏移量并执行原生SQL
    $offset = ($page - 1) * $limit;
    $sql = "SELECT * FROM your_target_table LIMIT :limit OFFSET :offset";
    $stmt = $this->connection()->prepare($sql);
    $stmt->bindValue(':limit', $limit, \PDO::PARAM_INT);
    $stmt->bindValue(':offset', $offset, \PDO::PARAM_INT);
    $stmt->execute();
    
    // 返回符合CakePHP3分页要求的结果集
    return $this->connection()->newResultSet($stmt);
  }
}

关键说明 #

• 所有分页相关参数（包括自定义的extra）都会被打包进settings数组，无需再依赖固定索引的func_get_arg()调用
• 必须确保Table的paginate方法返回CakePHP3能识别的结果集（如ResultSet对象），否则分页组件无法正常工作

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