yii2 activecontroller 默认支持分页，需满足：继承 activecontroller、返回 activedataprovider 实例、请求带 page/per-page 参数；可自定义参数名、扩展 pagesizelimit、手动注入 _meta 分页信息，并确保 query 固化排序与条件。
Yii2 RESTful 控制器里怎么开分页
直接给结论：Yii2 的 ActiveController 默认就支持分页，但必须满足两个前提——数据源是 ActiveDataProvider，且请求带 page 和 per-page 参数。不手动写逻辑也能跑起来，但很多人卡在配置没生效。
常见错误现象：GET /api/users 返回全部数据，不分页；或者返回 400 错误说 per-page 超限；又或者分页参数被忽略，始终只返回第一页。
- 确保控制器继承
ActiveController（不是Controller），否则serializeData()不会自动处理DataProvider - 重写
actions()方法，显式启用index动作，并确认它返回的是ActiveDataProvider实例（不是数组或ArrayDataProvider） -
per-page默认上限是 50，超这个值会报错；可在behaviors()里调大pageSizeLimit，比如设成[1, 200]
怎么控制分页参数名和默认值
Yii2 默认认 page 和 per-page，但前端可能传 offset/limit 或 page_number/page_size。硬改前端成本高，不如后端适配。
关键在 ActiveDataProvider 初始化时的 pagination 配置，以及 UrlRule 对参数的映射是否松散。
- 在控制器的
index()方法里，手动 newActiveDataProvider，把pagination设为['pageParam' => 'page_number', 'pageSizeParam' => 'page_size'] - 如果用路由规则做参数转换（比如把
/users?page=2&size=10映射成page/per-page），注意UrlRule::pattern不影响 query string 解析，得靠request->get()预处理 - 别在
urlManager里强行重写 query 参数名——Yii2 的分页组件只读request->get()，不走路由解析
分页响应体里怎么加总条数和页码信息
默认只返回当前页数据，没有 total、pageCount 这类字段。前端要做分页控件就得这些数据，但 Yii2 不自动塞进 JSON 响应里。
原因在于 ActiveController::serializeData() 只序列化 $data（即 dataProvider->getModels()），而分页元信息在 $dataProvider->getPagination() 里，得手动合并。
- 重写控制器的
serializeData()方法，在父类返回结果基础上，追加'_meta' => ['totalCount' => $provider->totalCount, 'pageCount' => $provider->getPagination()->getPageCount()] - 注意
totalCount是全量计数，如果数据量大且查询慢，考虑关掉（设totalCount = false），或用估算值替代 - 别在
afterAction里改响应体——此时 JSON 已序列化，再改容易出编码或结构问题
为什么分页后排序失效或条件丢失
典型表现：加了 orderBy，但第 2 页开始顺序乱；或者带 filter 查询，翻页后条件没了。根本原因是 ActiveDataProvider 的 query 没固化好。
分页过程会多次执行 count() 和 all()，如果 query 是动态构建的（比如每次 index() 都 new 一个没绑定条件的 Query），就会漏掉 filter 或 order。
- 把过滤逻辑（如
andFilterWhere()）写在ActiveDataProvider初始化前的Query对象上，而不是在search()方法里临时拼 - 确保
orderBy是硬编码或从安全白名单里取，别依赖用户传的sort参数——除非你启用了Sort组件并做了字段限制 - 检查是否误用了
asArray()：开了之后ActiveDataProvider仍能分页，但某些关联字段或 getter 可能失效，导致排序依据丢失
最易被忽略的一点：ActiveDataProvider 的 query 属性一旦被赋值，就不能再链式调用修改；想动态加条件，得在 new 之前就 finish 掉所有 where/orderBy 调用。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
